README.md

RabbitMQ setup

• Install rabbitMQ locally.
• Create a local rabbitMQ server with default settings:
  • Should be accessible at amqp://guest:guest@localhost:5672.
  • You can open http://localhost:15672/ and use guest as username & password.
• On macbook, this may work:

  CONF_ENV_FILE="/opt/homebrew/etc/rabbitmq/rabbitmq-env.conf" /opt/homebrew/opt/rabbitmq/sbin/rabbitmq-server
  

Postgres DB setup

• Install postgresql locally.
• Run psql.
• Create a user dev to manage db.
• Create arcpay database which will host all our tables: create databse arcpay.
• Run cargo run -- --merkle new to create a test table with configuration:

  CREATE TABLE test (
    leaf NUMERIC(78,0) NOT NULL, -- 32 bytes
    index NUMERIC(10,0) NOT NULL, -- 5 bytes
    PRIMARY KEY (index)
  );

• If you have already set up these DB tables previously, the command will terminate with an error. In that case, run cargo run -- --merkle load to set up connection to the DB.

GraphQL server setup

reference for graphql server: https://oliverjumpertz.com/how-to-build-a-powerful-graphql-api-with-rust/

• cargo run -- --merkle <OPTION> also launches a GraphQL server. Launch localhost:8080 to see its interface.

• Execute the query:

  query Query {
      root
  }
  

• For inserting:

  mutation {
    unsafeInsert(
      leaf: {
        address: [78, 171, 15, 165, 90, 108, 113, 192, 194, 59, 208, 230, 124, 6, 104, 43, 76, 231, 138, 127],
        lowCoin: 0,
        highCoin: 10
      }) {
      leaf,
      root
    }
  }
  

• For sending:

  mutation {
    unsafeSend(
      leaf: {
        address: [78, 171, 15, 165, 90, 108, 113, 192, 194, 59, 208, 230, 124, 6, 104, 43, 76, 231, 138, 127],
        lowCoin: 0,
        highCoin: 10
      },
      key: 0,
      highestCoinToSend: 5,
      recipient: [218, 30, 169, 125, 76, 109, 114, 49, 37, 178, 110, 74, 20, 65, 195, 153, 208, 234, 11, 228],
      sig: {
        sig: [
          228, 164, 161,  86, 150,  56,  88,  85,
          172,  99, 204,  40,  86, 122, 129,  60,
          124, 240,  72, 143, 236, 153,  69, 172,
          173,  44, 142, 217, 241, 167, 164, 117,
           42, 163, 171, 214, 152, 150, 246,
           73, 188,  76, 150,  86,  73, 212,
           91,  81, 144, 132,  31, 102, 178,
          232, 126, 139, 171, 194, 239, 165,
          105, 149, 199, 178
        ],
        pubkey: [
            4, 218, 175, 173, 110, 253, 117,  16, 114, 241,  71,
          131, 180, 234,   4,  43,  74, 138, 113, 157,  84,  58,
          188,  53, 189,  44, 126, 239, 253,  71, 143, 158,  58,
          218, 248,  50, 123, 163,  50, 254,  36, 202,   2, 172,
           56,   1, 162, 132, 252, 234, 157, 196, 160, 124, 109,
          212, 115, 244,   0, 188,  61, 175,  87,  28,  79,
        ]
      }
    )
  }
  

• Now query the root again to see the update. Also try localhost:8080/health.

Next steps

• Create table to store leaf has pre-image:

  CREATE TABLE state_tree (
    leaf NUMERIC(78,0) NOT NULL, -- 32 bytes
    owner NUMERIC(49,0) NOT NULL, -- 20 bytes
    coin_low NUMERIC(13,0) NOT NULL, -- 5 bytes
    coin_high NUMERIC(13,0) NOT NULL, -- 5 bytes
    PRIMARY KEY (leaf),
  );