Skip to main content

JSON RPC Documentation

For an end user or application to interact with MOI Network, either to submit Interactions or read state information, it must connect to MOI Node that exposes its JSON-RPC endpoint. The JSON-RPC API of MOI is transport agnostic and uses JSON for data exchange. Interactions are serialized with POLO before signing.

Client Libraries​

While it is acceptable to directly communicate with MOI Nodes with the JSON-RPC API, an easier option is to use a client library or wrapper SDK to handle the heavy lifting. Some available SDKs are:

  • JS-MOI-SDK (Javascript & Typescript SDK)

Conventions​

TesseractOptions Parameter​

Some JSON-RPC methods have an additional parameter to specify some TesseractOptions to define the default Tesseract. It is represented as an object with the following fields for either a Tesseract Number or Hash:

Field NameTypeDescription
tesseract_numberNUMBERTesseract Number
tesseract_hashHEXTesseract Hash
note

If both tesseract_number and tesseract_hash are provided, an error is returned.

To indicate the earliest or latest Tesseract, use the following values for tesseract_number:

  • 0 for the earliest Tesseract
  • -1 for the latest Tesseract

Hex Value Encoding​

There are two main types of data that are passed over JSON:

  1. Unformatted byte arrays
  2. Quantities (like NUMBERs and numbers)

These are both passed with a hex encoding, but they have different formatting requirements.

Quantities Formatting Rules​

When we encode quantities such as NUMBERs and numbers, we use the following rules:

  1. Encode as hex.
  2. Prefix with "0x".
  3. Use the most compact representation.
  4. Zero should be represented as "0x0" (slight exception to rule 3).

Examples​

Hex ValueDecimal EquivalentIs it Correct?
0x4165Yes
0x4001024Yes
0xN/ANo (should always have at least one digit - zero is "0x0")
0x04001024No (no leading zeroes allowed)
ff255No (must be prefixed with 0x)

Interactions​

A Interaction enable you to submit a group of Operations to the network as a single Interaction. When you submit an Interaction using the endpoints listed below, you'll receive an Interaction Hash. This hash can be used to query the interaction's receipt via the moi.InteractionReceipt API. The interactions receipt has the result of operation stored within the ix_operations field along with operation type and status.

MOI Core APIs​

moi.Call​

The moi.Call method enables users to perform a stateless simulation of submitting an interaction. This means that it executes the interaction without permanently recording it on the blockchain. It operates similarly to moi.SendInteractions, but with the key difference that the user is not required to sign the interaction.

Parameters:​

ParameterTypeDescription
senderSenderObject containing details of the interaction sender
payerHEX (32 bytes)Unique identifier of the payer [optional]
fuel_priceHEXFuel price
fuel_limitHEXFuel limit
ix_operationsArrayList containing one or more participant create, account configure, account inherit, asset create, asset action, logic deploy or logic invoke operations.
participantsArrayList of participants involved in the interaction, each defining an participants’s role, locking behavior, and notary status
preferencesIxPreferencesDefines the compute and consensus preferences for the interaction [optional]
perceptionBytesEncoded representation of the perceived asset value at the time of interaction (e.g., 1 KMOI token = 1 USD) [optional]
optionsMAP [ [ParticipantID] -> TesseractOptions ]Options for querying the tesseract.

Returns:​

ReturnTypeDescription
ix_hashHEX (32 Bytes)The interaction hash.
ts_hashHEX (32 Bytes)The tesseract hash.
fromHEX (32 Bytes)The id of the sender who sent the interaction.
statusNUMBERThe status of the interaction.
fuel_usedHEXThe amount of fuel used by this specific interaction alone.
ix_operationsARRAYThe list of operation containing type, status and output
 curl --location 'https://voyage-rpc.moi.technology/babylon/' \
 --header 'Content-Type: application/json' \
 --data '{
     "method": "moi.Call",
     "params": [
       "ix_args": {
           "sender": {
             "id": "0x000000001ec28dabfc3e4ac4dfc2084b45785b5e9cf1287b63a4f46900000000",
             "sequence": 8,
             "key_id": 0
           },
           "fuel_price": 1,
           "fuel_limit": 10000,
           "ix_operations": [
             {
               "type": 5,
               "payload": {
                 "asset_id": "0x10030000d9f12d13c0347a737430cdbcca174164f0823ccc39bedbe800000000",
                 "callsite": "Mint",
                 "calldata": "0d6f06659601c502616d6f756e7403138862656e656669636961727906000000001ec28dabfc3e4ac4dfc2084b45785b5e9cf1287b63a4f46900000000"
               }
             }
           ],
           "participants": [
             {
               "id": "0x10030000d9f12d13c0347a737430cdbcca174164f0823ccc39bedbe800000000",
               "lock_type": 0
             },
             {
               "id": "0x000000001ec28dabfc3e4ac4dfc2084b45785b5e9cf1287b63a4f46900000000",
               "lock_type": 0
             }
           ]
       }
     ],
     "jsonrpc": "2.0",
     "id": 1
 }'

moi.SendInteractions​

The moi.SendInteractions method is employed to send an interaction to the network. This involves the ix_args field, which holds the encoded interaction object, and the signature field, which represents the user's signature of the interaction using their private key.

In simple terms, it's a way for the user to securely transmit and validate interactions on the blockchain.

{
  "ix_args": "0e9f020ef604f3088309a009ae09ee17f026f0265f0683049304000000001ec28dabfc3e4ac4dfc2084b45785b5e9cf1287b63a4f469000000000700000000000000000000000000000000000000000000000000000000000000000127101f0e2f0316050e7f0686048605d00c10030000d9f12d13c0347a737430cdbcca174164f0823ccc39bedbe8000000005472616e736665720d6f06659601c502616d6f756e7403138862656e65666963696172790600000000ed434a2ab138e69295e134686d57d80a9aa3325dbbde9bbf000000005f0eee04de095f0683048104000000001ec28dabfc3e4ac4dfc2084b45785b5e9cf1287b63a4f469000000005f068304910410030000d9f12d13c0347a737430cdbcca174164f0823ccc39bedbe800000000025f068304810400000000ed434a2ab138e69295e134686d57d80a9aa3325dbbde9bbf00000000",
  "signatures": "0e1f0e5f0683048604000000001ec28dabfc3e4ac4dfc2084b45785b5e9cf1287b63a4f46900000000014730450221008e0bb1066dd6f9a5cd06fc3e8b28245d26a9ade7e58f6662eac49c14454cb87e02203428233739f4727b1add08d31231025d39edf453d1de56249c678244bab4518403"
}

moi.Tesseract​

This method retrieves the tesseract by the provided options. The tesseract details can be fetched by either providing the id along with the tesseract number or by providing the tesseract hash alone.

Parameters:​

ParameterTypeDescription
idHEX (32 Bytes)The id of the sender requesting the tesseract.
with_interactionsBOOLEANIf true, it returns the interactions list as part of the tesseract.
optionsTesseractOptionsOptions for querying the tesseract.

Returns:​

ReturnTypeDescription
participantsARRAYAn array of participants involved in the interaction and their details.
interactions_hashHEX (32 Bytes)The hash of all the interactions in the tesseract.
receipts_hashHEX (32 Bytes)The hash of all the receipts.
hashHEX (32 Bytes)The hash of the tesseract.
sealHEXThe signature of node which executed the tesseract.
epochHEXEpoch denotes the fixed time slot.
time_stampHEXThe ICS request time.
operatorSTRINGThe krama ID of the operator node.
consensus_infoOBJECTAn object containing consensus related information.
fuel_usedHEXThe amount of fuel used until the tesseract formation.
fuel_limitHEXFuel limit.
ixnsARRAYIf with_interactions is set to true, an array of interactions is returned.
curl --location 'https://voyage-rpc.moi.technology/babylon/' \
--header 'Content-Type: application/json' \
--data '{
    "method": "moi.Tesseract",
    "params": [
        {
            "id": "0x45b9906e65c9bdf4703918aa2c78fe139ba8e32c5e0dcda585dac4c584651f08",
            "with_interactions": true,
            "options": {
                "tesseract_number": -1
            }
        }
    ],
    "jsonrpc": "2.0",
    "id": 1
}'
  curl --location 'https://voyage-rpc.moi.technology/babylon/' \
  --header 'Content-Type: application/json' \
  --data '{
      "method": "moi.Tesseract",
      "params": [
          {
              "with_interactions": true,
              "options": {
                  "tesseract_hash": "0x4f9991aabeb642ef4b45033038e9be2cd864c6b6ac8666d3b66818a7d76b50cc"
              }
          }
      ],
      "jsonrpc": "2.0",
      "id": 1
  }'

moi.InteractionByTesseract​

This method allows users to retrieve an interaction based on a given tesseract hash and interaction index. If the interaction index is not found, the function will throw an error.

Parameters:​

ParameterTypeDescription
idHEX (32 Bytes)The id of the sender.
optionsTesseractOptionsOptions for querying the tesseract.
ix_indexHEXRepresents the index of the interaction within the tesseract.

Returns:​

ReturnTypeDescription
nonceHEXThe nonce of the tesseract.
senderSenderObject containing details of the interaction sender.
payerHEX (32 Bytes)Payer id.
fuel_priceHEXThe fuel price for the interaction.
fuel_limitHEXThe fuel limit of the interaction.
operationsHEXThe list of operations.
hashHEX (32 Bytes)The hash of the interaction.
ts_hashHEX (32 Bytes)The hash of the tesseract.
signatureARRAYAn array of signature bytes associated with the interaction.
participantsARRAYAn array of participants involved in the interaction and their details.
ix_indexHEXAn NUMBER representing the interaction index in the tesseract.
curl --location 'https://voyage-rpc.moi.technology/babylon/' \
--header 'Content-Type: application/json' \
--data '{
    "method": "moi.InteractionByTesseract",
    "params": [
        {
            "id": "0x45b9906e65c9bdf4703918aa2c78fe139ba8e32c5e0dcda585dac4c584651f08",
            "options": {
                "tesseract_number": -1
            },
            "ix_index": "0x0"
        }
    ],
    "jsonrpc": "2.0",
    "id": 1
}'

moi.InteractionByHash​

This method retrieves the interaction details for a given interaction hash.

Parameters:​

ParameterTypeDescription
hashHEX (32 Bytes)Interaction hash for which you want to fetch interaction details.

Returns:​

ReturnTypeDescription
typeNUMBERType of the interaction.
nonceHEXThe nonce of the tesseract.
senderHEX (32 Bytes)Sender id.
fuel_priceHEXThe fuel price for the interaction.
fuel_limitHEXThe fuel limit of the interaction.
operationsHEXThe list of operations.
hashHEX (32 Bytes)The hash of the interaction.
ts_hashHEX (32 Bytes)The hash of the tesseract.
signatureARRAYAn array of signature bytes associated with the interaction.
participantsARRAYAn array of participants involved in the interaction and their details.
ix_indexHEXAn NUMBER representing the interaction index in the tesseract.
curl --location 'https://voyage-rpc.moi.technology/babylon/' \
--header 'Content-Type: application/json' \
--data '{
    "method": "moi.InteractionByHash",
    "params": [
        {
            "hash": "0xf4220d4caa3cfa0ee9ded4d01e43bc2890ab9152a789955fae4a45707f90fa0b"
        }
    ],
    "jsonrpc": "2.0",
    "id": 1
}'

moi.InteractionReceipt​

This method retrieves the receipt of a specific interaction in the system. The interaction is identified by its unique hash. The receipt provides detailed information about the interaction.

Parameters:​

ParameterTypeDescription
hashHEX (32 Bytes)The unique hash that identifies the interaction.

Returns:​

ReturnTypeDescription
ix_typeHEXThe type of the interaction in hex.
ix_hashHEX (32 Bytes)The unique hash of the interaction.
statusNUMBERThe status of the interaction.
fuel_usedHEXThe amount of fuel used by this specific interaction alone.
fromHEX (32 Bytes)The id of the sender.
ts_hashHEX (32 Bytes)The hash of the tesseract.
ix_indexHEXThe NUMBER representing the interaction index in the tesseract.
participantsARRAYAn array of participants involved in the interaction and their details.
operationsARRAYA list of operations
curl --location 'https://voyage-rpc.moi.technology/babylon/' \
--header 'Content-Type: application/json' \
--data '{
    "method": "moi.InteractionReceipt",
    "params": [
        {
            "hash": "0xc63135e38e9edfd68107f8efccbedcc4c8141984b383b941fe42070b867f2a85"
        }
    ],
    "jsonrpc": "2.0",
    "id": 1
}'

moi.InteractionCount​

This method helps to fetch the total number of interactions performed by a particular account.

Parameters:​

ParameterTypeDescription
idHEX (32 Bytes)The id of the account for which the total interaction count is queried.
optionsTesseractOptionsOptions for querying the tesseract.

Returns:​

Return TypeDescription
HEXThe total number of interactions that have been made by the queried account.
curl --location 'https://voyage-rpc.moi.technology/babylon/' \
--header 'Content-Type: application/json' \
--data '{
    "method": "moi.InteractionCount",
    "params": [
        {
            "id": "0x52fdfc072182654f163f5f0f9a621d729566c74d10037c4d7bbb0407d1e2c649",
            "options": {
                "tesseract_number": -1
            }
        }
    ],
    "jsonrpc": "2.0",
    "id": 1
}'

moi.PendingInteractionCount​

This method provides the total number of interactions for a given id, inclusive of both the completed and pending interactions in IxPool.

Parameters:​

NameTypeDescription
idHEX (32 Bytes)The id of the account for which the total number interaction count is queried.

Returns:​

Returns TypeDescription
HEXThe total number of interactions made by the queried account, including the pending interactions in IxPool.
curl --location 'https://voyage-rpc.moi.technology/babylon/' \
--header 'Content-Type: application/json' \
--data '{
    "method": "moi.PendingInteractionCount",
    "params": [
        {
            "id": "0x81855ad8681d0d86d1e91e00167939cb6694d2c422acd208a0072939487f6999"
        }
    ],
    "jsonrpc": "2.0",
    "id": 1
}'

moi.AccountMetaInfo​

This method provides metadata information about a specific account based on the provided account's id.

Parameters:​

ParameterTypeDescription
idHEX (32 Bytes)The account id for which metadata information is to be retrieved.

Returns:​

Return TypeDescription
OBJECTThe object contains meta information about the queried account.
curl --location 'https://voyage-rpc.moi.technology/babylon/' \
--header 'Content-Type: application/json' \
--data '{
    "method": "moi.AccountMetaInfo",
    "params": [
        {
            "id": "0x52fdfc072182654f163f5f0f9a621d729566c74d10037c4d7bbb0407d1e2c649",
            "options": {
                "tesseract_number": -1
            }
        }
    ],
    "jsonrpc": "2.0",
    "id": 1
}'

moi.AccountState​

This method returns the account for a provided id.

Parameters:​

ParameterTypeDescription
idHEX (32 Bytes)The id of the sender whose account state is to be retrieved.
optionsTesseractOptionsOptions for querying the tesseract.

Returns:​

Return TypeDescription
OBJECTThe object contains detailed information about the queried account.
curl --location 'https://voyage-rpc.moi.technology/babylon/' \
--header 'Content-Type: application/json' \
--data '{
    "method": "moi.AccountState",
    "params": [
        {
            "id": "0x52fdfc072182654f163f5f0f9a621d729566c74d10037c4d7bbb0407d1e2c649",
            "options": {
                "tesseract_number": -1
            }
        }
    ],
    "jsonrpc": "2.0",
    "id": 1
}'

moi.ContextInfo​

This method provides information the context information that is associated with the provided id. It includes the krama id's of the behaviour nodes, random nodes, and storage nodes that are part of this interaction.

Parameters:​

ParameterTypeDescription
idHEX (32 Bytes)The id of the sender.
optionsTesseractOptionsOptions for querying the tesseract.

Returns:​

ReturnsTypeDescription
behaviour_nodesARRAYA list of the krama id's of behaviour nodes that are part of the latest interaction.
random_nodesARRAYA list of the krama id's of random nodes that are part of the latest interaction.
storage_nodesARRAYA list of the krama id's of storage nodes that are part of the latest interaction.
curl --location 'https://voyage-rpc.moi.technology/babylon/' \
--header 'Content-Type: application/json' \
--data '{
    "method": "moi.ContextInfo",
    "params": [
        {
            "id": "0x52fdfc072182654f163f5f0f9a621d729566c74d10037c4d7bbb0407d1e2c649",
            "options": {
                "tesseract_number": -1
            }
        }
    ],
    "jsonrpc": "2.0",
    "id": 1
}'

moi.TDU​

This method is used to retrieve the Total Digital Utility (TDU) of a specific id. It is a method to get a list of all asset IDs associated with a given id and their total supply.

Parameters:​

ParameterTypeDescription
idHEX (32 Bytes)the id of the sender for which TDU is required.
optionsTesseractOptionsOptions for querying the tesseract.

Returns:​

Return TypeDescription
ARRAYA list of asset IDs and their respective total supply.
curl --location 'https://voyage-rpc.moi.technology/babylon/' \
--header 'Content-Type: application/json' \
--data '{
    "method": "moi.TDU",
    "params": [
        {
            "id": "0x52fdfc072182654f163f5f0f9a621d729566c74d10037c4d7bbb0407d1e2c649",
            "options": {
                "tesseract_number": -1
            }
        }
    ],
    "jsonrpc": "2.0",
    "id": 1
}'

moi.Balance​

This method is used to retrieve the current balance of a specified asset associated with a given account.

Parameters:​

ParameterTypeDescription
idHEX (32 Bytes)The id for which the balance needs to be retrieved.
asset_idAssetIDThe ID of the asset for which the balance is to be retrieved.
optionsTesseractOptionsOptions for querying the tesseract.

Returns:​

Return TypeDescription
NUMBERAn NUMBER representing the current balance of the queried asset.
curl --location 'https://voyage-rpc.moi.technology/babylon/' \
--header 'Content-Type: application/json' \
--data '{
    "method": "moi.Balance",
    "params": [
        {
            "id": "0x81855ad8681d0d86d1e91e00167939cb6694d2c422acd208a0072939487f6999",
            "asset_id": "0000ed517b0e68a54bf19fa0a1f88130a0503b18b258f7f7042e03f1518e4ab015bc",
            "options": {
                "tesseract_number": -1
            }
        }
    ],
    "jsonrpc": "2.0",
    "id": 1
}'

moi.Registry​

This method is used to obtain a list of registries that store asset IDs and their corresponding asset descriptions.

Parameters:​

ParameterTypeDescription
idHEX (32 Bytes)The id for which the registries need to be retrieved.
optionsTesseractOptionsOptions for querying the tesseract.

Returns:​

Return TypeDescription
ARRAYA list of registries that store asset IDs and their corresponding asset descriptions.
curl --location 'https://voyage-rpc.moi.technology/babylon/' \
--header 'Content-Type: application/json' \
--data '{
    "method": "moi.Registry",
    "params": [
        {
            "id": "0x81855ad8681d0d86d1e91e00167939cb6694d2c422acd208a0072939487f6999",
            "options": {
                "tesseract_number": -1
            }
        }
    ],
    "jsonrpc": "2.0",
    "id": 1
}'

moi.Syncing​

This method returns the sync status of an account if id is given else returns the node sync status. If the pending accounts variable is set to true, it returns the node sync status with a list of accounts awaiting synchronization.

Parameters:​

ParameterTypeDescription
idHEX (32 Bytes)The id of the account for which the sync status is to be determined
pending_accountsBOOLEANIf true, it provides a list of accounts awaiting synchronization as part of the node sync status.

Returns:​

ReturnTypeDescription
account_sync_statusOBJECTThe sync status of the account for which id is given
node_sync_statusOBJECTThe sync status of the node
curl --location 'https://voyage-rpc.moi.technology/babylon/' \
--header 'Content-Type: application/json' \
--data '{
    "method": "moi.Syncing",
    "params": [
        {
            "id": "0xa6ba9853f131679d00da0f033516a2efe9cd53c3d54e1f9a6e60e9077e9f9384"
        }
    ],
    "jsonrpc": "2.0",
    "id": 1
}'
curl --location 'https://voyage-rpc.moi.technology/babylon/' \
--header 'Content-Type: application/json' \
--data '{
    "method": "moi.Syncing",
    "params": [
        {
            "pending_accounts": true
        }
    ],
    "jsonrpc": "2.0",
    "id": 1
}'

moi.FuelEstimate​

This method returns an estimate of the fuel that is required for executing an interaction.

Parameters:​

ParameterTypeDescription
senderSenderObject containing details of the interaction sender
payerHEX (32 bytes)Unique identifier of the payer [optional]
fuel_priceHEXFuel price
fuel_limitHEXFuel limit
ix_operationsArrayList containing one or more participant create, account configure, account inherit, asset create, asset action, logic deploy or logic invoke operations.
participantsArrayList of participants involved in the interaction, each defining an participants’s role, locking behavior, and notary status
preferencesIxPreferencesDefines the compute and consensus preferences for the interaction [optional]
perceptionBytesEncoded representation of the perceived asset value at the time of interaction (e.g., 1 KMOI token = 1 USD) [optional]
optionsMAP [ [ParticipantID] -> TesseractOptions ]Options for querying the tesseract.

Returns:​

Return TypeDescription
fuel_usedAn estimate of the amount of fuel used by this specific interaction alone.
curl --location 'https://voyage-rpc.moi.technology/babylon/' \
--header 'Content-Type: application/json' \
--data '{
  "method": "moi.FuelEstimate",
  "params": [
      {
        "ix_args": {
            "sender": {
              "id": "0x000000001ec28dabfc3e4ac4dfc2084b45785b5e9cf1287b63a4f46900000000",
              "sequence": 8,
              "key_id": 0
            },
            "fuel_price": 1,
            "fuel_limit": 10000,
            "ix_operations": [
              {
                "type": 5,
                "payload": {
                  "asset_id": "0x10030000d9f12d13c0347a737430cdbcca174164f0823ccc39bedbe800000000",
                  "callsite": "Mint",
                  "calldata": "0d6f06659601c502616d6f756e7403138862656e656669636961727906000000001ec28dabfc3e4ac4dfc2084b45785b5e9cf1287b63a4f46900000000"
                }
              }
            ],
            "participants": [
              {
                "id": "0x10030000d9f12d13c0347a737430cdbcca174164f0823ccc39bedbe800000000",
                "lock_type": 0
              },
              {
                "id": "0x000000001ec28dabfc3e4ac4dfc2084b45785b5e9cf1287b63a4f46900000000",
                "lock_type": 0
              }
            ]
        }
      }
  ],
  "jsonrpc": "2.0",
  "id": 1
}'

moi.AssetInfoByAssetID​

This method provides detailed information about a specific asset identified by the provided asset ID.

Parameters:​

ParameterTypeDescription
asset_idAssetIDThe asset ID for which the information is to be retrieved.
optionsTesseractOptionsOptions for querying the tesseract.

Returns:​

ReturnTypeDescription
symbolSTRINGThe symbolic representation of the asset.
operatorHEX (32 Bytes)The id of the operator of the asset.
supplyHEXThe total supply of the asset.
dimensionHEXThe dimensions of the asset.
standardHEXIndicates the asset standard.
is_logicalBOOLEANIndicates whether the asset is logical or not.
is_statefulBOOLEANIndicates whether the asset is stateful or not.
logic_idLogicIDThe logic id associated with the asset.
curl --location 'https://voyage-rpc.moi.technology/babylon/' \
--header 'Content-Type: application/json' \
--data '{
    "method": "moi.AssetInfoByAssetID",
    "params": [
      {
        "asset_id":"0x000000009d8810a510ec135b73848a9de05ed747fbbeedfbf689583f59e50dca0089b7c4",
        "options":{
          "tesseract_number":-1
        }
      }
    ],
    "jsonrpc": "2.0",
    "id": 1
}'

moi.LogicIDs​

This method is used to retrieve a list of all the logic IDs associated with a specific logic id.

Parameters:​

ParameterTypeDescription
idHEX (32 Bytes)The id of the sender for which the logic IDs are required.
optionsTesseractOptionsOptions for querying the tesseract.

Returns:​

Return TypeDescription
ARRAYA list of logic IDs.
curl --location 'https://voyage-rpc.moi.technology/babylon/' \
--header 'Content-Type: application/json' \
--data '{
    "method": "moi.LogicIDs",
    "params": [
        {
            "id": "0x52fdfc072182654f163f5f0f9a621d729566c74d10037c4d7bbb0407d1e2c649",
            "options": {
                "tesseract_number": -1
            }
        }
    ],
    "jsonrpc": "2.0",
    "id": 1
}'

moi.LogicManifest​

This method retrieves the manifest associated with a specific logicID.

Parameters:​

ParameterTypeDescription
logic_idLogicIDThe unique identifier of the logic for which the manifest is to be returned.
encodingSTRINGSpecifies the encoding type of the manifest. It should be JSON, POLO, or YAML.
optionsTesseractOptionsOptions for querying the tesseract.

Returns:​

Return TypeDescription
HEXContains the manifest associated with the given logic ID, encoded in the requested format.
curl --location 'https://voyage-rpc.moi.technology/babylon/' \
--header 'Content-Type: application/json' \
--data '{
  "method": "moi.LogicManifest",
  "params": [
    {
      "logic_id": "0800009259ee349d92e578e7ae0150d8f8ffa1aa73535baecf3ae18c3e7ea8e305b3f5",
      "encoding": "JSON",
      "options": {
          "tesseract_number": -1
      }
    }
  ],
  "jsonrpc": "2.0",
  "id": 1
}'

moi.LogicStorage​

This method is used to retrieve the data associated with a particular storage slot and Logic ID. This can be useful when you want to inspect or read the data that is stored in a specific slot of a logic entity.

Parameters:​

ParameterTypeDescription
logic_idLogicIDThe id of the logic whose associated data is to be accessed.
storage-keyStorageKeyThe key of the storage slot hash whose data is to be accessed. It's represented as hexadecimal of 32 bytes long.
optionsTesseractOptionsOptions for querying the tesseract.

Returns:​

Return TypeDescription
HEXThe data associated with the given logic id and storage slot within the tesseract.
curl --location 'https://voyage-rpc.moi.technology/babylon/' \
--header 'Content-Type: application/json' \
--data '{
    "method": "moi.LogicStorage",
    "params": [
      {
        "logic_id": "0800009259ee349d92e578e7ae0150d8f8ffa1aa73535baecf3ae18c3e7ea8e305b3f5",
        "storage_key": "03170a2e7597b7b7e3d84c05391d139a62b157e78786d8c082f29dcf4c111314",
        "options": {
            "tesseract_number": -1
        }
      }
    ],
    "jsonrpc": "2.0",
    "id": 1
}'

moi.GetLogs​

This method is used to get all the tesseract logs for an account within a given tesseract range.

Note: Difference between start height and end height should be less than or equal to 10 tesseracts

Parameters:​

ParameterTypeDescription
idHEX (32 Bytes)The account id for which you are requesting logs
start_heightNUMBERThe start height of the tesseract
end_heightNUMBERThe end height of the tesseract
topicsARRAYAn array of topic hashes in order
Type of topic queries:​
ParameterDescription
[] or nilmatches any topic list
[[A]]matches topic A in first position
[[], [B]]matches any topic in first position AND B in second position
[[A], [B]]matches topic A in first position AND B in second position
[[A], [B]], [[C], [D]]matches topic (A OR B) in first position AND (C OR D) in second position

Returns:​

ReturnTypeDescription
idHEX (32 Bytes)The id of the sender
logic_idLogicIDThe unique identifier of the logic for which the manifest is to be returned.
topicsARRAYAn array of hashes representing the indexed parameters in an event, where the first topic corresponds to the event signature.
dataARRAYAn array of bytes representing the data in the event.
ix_hashHEX (32 Bytes)The hash of all the interactions in the tesseract.
ts_hashHEX (32 Bytes)The hash of the tesseract.
participantsARRAYAn array of participants involved in the interaction and their details.
  curl --location 'https://voyage-rpc.moi.technology/babylon/' \
  --header 'Content-Type: application/json' \
  --data '{
      "method": "moi.GetLogs",
      "params": [
          {
              "id": "0x5fc0247c18448e91d15542ffb7a0956b6d5f1a19bdd11a36e6a1f7369288f886",
              "start_height": 0,
              "end_height": 9,
              "topics": [
                  ["0x223c39e29dff6467fedda09758d91781c5372e091ff86b3af9e310e386562bef"],
                  [
                      "0x91f07c7f1215b122f8ac96a1f841293a2a0796395b4e46d2174b4d16f89de12c",
                      "0x0000000000000000000000000aff3454fce5edbc8cca8697c15331677e6ebccc"
                  ]
              ]
          }
      ],
      "jsonrpc": "2.0",
      "id": 1
  }'

moi.NewTesseractFilter​

This method is used to set up a filter to get all new terreracts since filter is set up. The method has a timeout period of 1 minute. Each time we query, the timeout is reset to 1 minute.

Parameters:​

This method does not require any parameters.

Returns:​

ReturnTypeDescription
idSTRINGThe object containing the Filter ID for NewTesseractFilter
curl --location 'https://voyage-rpc.moi.technology/babylon/' \
--header 'Content-Type: application/json' \
--data '{
    "method":"moi.NewTesseractFilter",
    "jsonrpc":"2.0",
    "id":1
}'

moi.NewTesseractsByAccountFilter​

This method is used to set up a filter to get all new terreracts for the given account since filter is set up. The method has a timeout period of 1 minute. Each time we query, the timeout is reset to 1 minute.

Parameters:​

ParameterTypeDescription
idHEX (32 Bytes)The id of the account you want to get new tesseracts for

Returns:​

ReturnTypeDescription
idSTRINGThe object containing the Filter ID for NewTesseractsByAccountFilter
curl --location 'https://voyage-rpc.moi.technology/babylon/' \
--header 'Content-Type: application/json' \
--data '{
    "method":"moi.NewTesseractsByAccountFilter",
    "params":[
        {
            "id":"0x9673f1882112b218e5be9f2e0c8a65ce2b3f35ecd4e056dde4d9084229ddaa4e"
        }
      ],
      "jsonrpc":"2.0",
      "id":1
}'

moi.NewLogFilter​

This method is used to set up a filter to get all new tesseract logs for the given account since filter is set up. The method has a timeout period of 1 minute. Each time we query, the timeout is reset to 1 minute.

Note: Difference between start height and end height should be less than or equal to 10 tesseracts

Parameters:​

ParameterTypeDescription
idHEX (32 Bytes)The account id for which you are requesting logs
start_heightNUMBERThe start height of the tesseract
end_heightNUMBERThe end height of the tesseract
topicsARRAYAn array of topic hashes in order
Type of topic queries:​
ParameterDescription
[] or nilmatches any topic list
[[A]]matches topic A in first position
[[], [B]]matches any topic in first position AND B in second position
[[A], [B]]matches topic A in first position AND B in second position
[[A], [B]], [[C], [D]]matches topic (A OR B) in first position AND (C OR D) in second position

Returns:​

ReturnTypeDescription
idSTRINGThe object containing the Filter ID for NewLogFilter
  curl --location 'https://voyage-rpc.moi.technology/babylon/' \
  --header 'Content-Type: application/json' \
  --data '{
      "method": "moi.NewLogFilter",
      "params": [
          {
              "id": "0x5fc0247c18448e91d15542ffb7a0956b6d5f1a19bdd11a36e6a1f7369288f886",
              "start_height": 0,
              "end_height": 2,
              "topics": [
                  ["0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b"],
                  [
                      "0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
                      "0x0000000000000000000000000aff3454fce5edbc8cca8697c15331677e6ebccc"
                  ]
              ]
          }
      ],
      "jsonrpc": "2.0",
      "id": 1
  }'

moi.PendingIxnsFilter​

This method is used to set up a filter to get all new interactions in ixpool since filter is set up. The method has a timeout period of 1 minute. Each time we query, the timeout is reset to 1 minute.

Parameters:​

This method does not require any parameters.

Returns:​

ReturnTypeDescription
idSTRINGThe object containing the Filter ID for PendingIxnsFilter
curl --location 'https://voyage-rpc.moi.technology/babylon/' \
--header 'Content-Type: application/json' \
--data '{
    "method":"moi.PendingIxnsFilter",
    "jsonrpc":"2.0",
    "id":1
}'

moi.RemoveFilter​

This method is used to remove a filter.

Parameters:​

ParameterTypeDescription
idSTRINGThe object containing the Filter ID of the filter you want to remove

Returns:​

ReturnTypeDescription
statusBOOLReturns true on successful removal of filter, else false
curl --location 'https://voyage-rpc.moi.technology/babylon/' \
--header 'Content-Type: application/json' \
--data '{
    "method":"moi.RemoveFilter",
    "params":[
        {
            "id": "4155a053-7b74-46ac-98b6-9f440e27e2e5"
        }
    ],
    "jsonrpc":"2.0",
    "id":1
}'

moi.GetFilterChanges​

This method is used to get all filter changes since the last poll. The result varies based on filter.

Parameters:​

ParameterTypeDescription
idSTRINGThe object containing the Filter ID of the filter you want changes for

Returns:​

ReturnTypeDescription
dataJSONThe object data varies based on filter. Example used: moi.NewTesseractFilter
curl --location 'https://voyage-rpc.moi.technology/babylon/' \
--header 'Content-Type: application/json' \
--data '{
    "method":"moi.GetFilterChanges",
    "params":[
        {
            "id": "4ef7b0b7-6a21-4522-a8d6-78296cc2d028"
        }
    ],
    "jsonrpc":"2.0",
    "id":1
}'

IxPool APIs​

ixpool.ContentFrom​

This method is used to fetch detailed information about the interactions that are pending for inclusion in the next Tesseract(s) or are scheduled for future execution. This information is fetched based on the id provided as a parameter.

Parameters:​

ParameterTypeDescription
idHEX (32 Bytes)The id of the sender.

Returns:​

ReturnTypeDescription
pendingOBJECTThe object containing details of pending interactions for the given id.
queuedOBJECTThe object containing details of queued interactions for the given id.
curl --location 'https://voyage-rpc.moi.technology/babylon/' \
--header 'Content-Type: application/json' \
--data '{
    "method": "ixpool.ContentFrom",
    "params": [
        {
            "id": "0x52fdfc072182654f163f5f0f9a621d729566c74d10037c4d7bbb0407d1e2c649"
        }
    ],
    "jsonrpc": "2.0",
    "id": 1
}'

ixpool.WaitTime​

This method is used to retrieve the waiting time for an account in ixpool. It's a way to check how long an account has to wait in the queue to get processed.

Parameters:​

ParameterTypeDescription
idHEX (32 Bytes)The id of the account for which the wait time has to be retrieved.

Returns:​

ReturnTypeDescription
expiredBOOLEANIndicates whether if it has exceeded the wait time
timeDURATIONThe amount of time the account will have to wait in the queue to get processed (expressed in milliseconds)
curl --location 'https://voyage-rpc.moi.technology/babylon/' \
--header 'Content-Type: application/json' \
--data '{
    "method": "ixpool.WaitTime",
    "params": [
        {
            "id": "0x52fdfc072182654f163f5f0f9a621d729566c74d10037c4d7bbb0407d1e2c649"
        }
    ],
    "jsonrpc": "2.0",
    "id": 1
}'

ixpool.Content​

This method is used to retrieve a comprehensive list of all interactions that are awaiting inclusion in the upcoming Tesseract(s). It also retrieves all the interactions that are scheduled for execution in the future.

Parameters:​

This method does not require any parameters.

Returns:​

Return TypeDescription
OBJECTThe object contains a list of all pending and queued interactions
curl --location 'https://voyage-rpc.moi.technology/babylon/' \
--header 'Content-Type: application/json' \
--data '{
    "method": "ixpool.Content",
    "jsonrpc": "2.0",
    "id": 1
}'

ixpool.Inspect​

This method provides a summary of all the interactions that are currently waiting to be included in the next Tesseract(s), as well as interactions scheduled for future execution. Additionally, it provides a list of all the accounts in the ixpool with their respective wait times. This method is particularly useful for developers, as it can help them quickly review interactions in the pool and identify any potential issues.

Parameters:​

This method does not require any parameters.

Returns:​

Return TypeDescription
OBJECTThe object contains a simplified, readable list of all interactions that are waiting for inclusion in the next Tesseract and are scheduled for future execution. It also includes a list of accounts with their respective wait times.
curl --location 'https://voyage-rpc.moi.technology/babylon/' \
--header 'Content-Type: application/json' \
--data '{
    "method": "ixpool.Inspect",
    "jsonrpc": "2.0",
    "id": 1
}'

ixpool.Status​

This method provides a summary of all the interactions that are currently pending for inclusion in the next Tesseract(s) and interactions that are scheduled for future execution. This method is particularly useful for developers, as it can help them quickly review interactions and identify any potential issues.

Parameters:​

This method does not require any parameters.

Returns:​

Return TypeDescription
OBJECTAn object containing the number of pending and queued interactions.
curl --location 'https://voyage-rpc.moi.technology/babylon/ \
--header 'Content-Type: application/json' \
--data '{
    "method": "ixpool.Status",
    "jsonrpc": "2.0",
    "id": 1
}'

Net APIs​

net.Peers​

This method allows you to retrieve a list of peers in the network. Peers are represented by their unique Krama IDs.

Parameters:​

This method doesn't require any parameters.

Returns:​

Return TypeDescription
ARRAYA list of Krama IDs, each representing a unique peer in the network.
curl --location 'https://voyage-rpc.moi.technology/babylon/' \
--header 'Content-Type: application/json' \
--data '{
    "method": "net.Peers",
    "jsonrpc": "2.0",
    "id": 1
}'

net.Version​

This method is used to get the version of the software running.

Parameters:​

This method does not require any parameters.

Returns:​

Return TypeDescription
STRINGThe version of the software running.
curl --location 'https://voyage-rpc.moi.technology/babylon/' \
--header 'Content-Type: application/json' \
--data '{
    "method": "net.Version",
    "jsonrpc": "2.0",
    "id": 1
}'

net.Info​

This method is used to get the Krama ID of the node.

Parameters:​

This method does not require any parameters.

Returns:​

Return TypeDescription
OBJECTKrama ID of the node.
curl --location 'https://voyage-rpc.moi.technology/babylon/' \
--header 'Content-Type: application/json' \
--data '{
    "method": "net.Info",
    "jsonrpc": "2.0",
    "id": 1
}'

Debug APIs​

debug.DBGet​

This method is used to retrieve raw value of a particular key stored in the database.

Parameters:​

ParameterTypeDescription
storage_keyDBkeyThis is the unique identifier for the stored data you want to retrieve. This is represented as hexadecimal of 65 bytes long.

Returns:​

Return TypeDescription
OBJECTThis is the raw value that is stored in the database corresponding to the provided storage key.
curl --location --request POST 'http://localhost:1600/' \
--header 'Content-Type: application/json' \
--data-raw '{
  "method": "debug.DBGet",
  "params": [
    {
      "storage_key":"6275636b657400000384a6ba9853f131679d00da0f033516a2efe9cd53c3d54e1f9a6e60e9077e9f9384"
    }
  ],
  "jsonrpc": "2.0",
  "id": 1
}'

debug.NodeMetaInfo​

This method retrieves the metadata for a specific peer based on the provided parameters. If no parameters are provided, it returns metadata for all peers available in the database.

Parameters:​

ParameterTypeDescription
peer_idSTRINGThe peer id of the node for which metadata is requested (optional).
krama_idSTRINGThe krama id of the node for which metadata is requested (optional).

Returns:​

Return TypeDescription
OBJECTThe object contains node meta info for the specific node or all nodes in the database.
curl --location --request POST 'http://localhost:1600/' \
--header 'Content-Type: application/json' \
--data-raw '{
  "method": "debug.NodeMetaInfo",
  "params": [{}],
  "jsonrpc": "2.0",
  "id": 1
}'

debug.Accounts​

This method is used to fetch a list of all registered account addresses.

Parameters:​

This method does not require any parameters.

Returns:​

Return TypeDescription
ARRAYThis contains a list of addresses of all registered accounts.
curl --location 'http://localhost:1600/' \
--header 'Content-Type: application/json' \
--data '{
    "method": "debug.Accounts",
    "jsonrpc": "2.0",
    "id": 1
}'

debug.Connections​

This method is used to fetch a list of active connections and connection stats.

Parameters:​

This method does not require any parameters.

Returns:​

ReturnTypeDescription
connsARRAYAn array of active connections.
inbound_conn_countINTThe number of in-bound connections.
outbound_conn_countINTThe number of out-bound connections.
active_pub_sub_topicsMAP [ [STRING] -> INT ]Active pub-sub topics.
curl --location 'http://localhost:1601/' \
--header 'Content-Type: application/json' \
--data '{
    "method": "debug.Connections",
    "jsonrpc": "2.0",
    "id": 1
}'

debug.Diagnosis​

This method initiates a diagnosis process with the provided parameters, collects various diagnostic information for the moipod.

Parameters:​

ParameterTypeDescription
output_pathSTRINGThe path where diagnostic information will be stored.
collectorsSTRINGAn array of specific diagnostic data collectors to include in the diagnosis. Options include: goroutines-stack, goroutines-pprof, version, heap, allocs, cpu, mutex, block.
profile_timeSTRINGThe duration for which profiling data should be collected (e.g., "2m" for 2 minutes).
mutex_profile_fractionNUMBERFractional sampling rate for mutex profiling.
block_profile_rateSTRINGThe rate at which block (contention) profiling data should be collected (e.g., "5s" for every 5 seconds).

Returns:​

Return TypeDescription
OBJECTAn empty object.
curl --location --request POST 'http://localhost:1600/' \
--header 'Content-Type: application/json' \
--data-raw '{
  "method": "debug.Diagnosis",
  "params": [
    {
      "output_path": "/path/go-moi",
      "collectors": [],
      "profile_time": "2m",
      "mutex_profile_fraction": 4,
      "block_profile_rate": "5s"
    }
  ],
  "jsonrpc": "2.0",
  "id": 1
}'

debug.SyncJob​

This method returns the sync job meta info for a given id.

Parameters:​

ParameterTypeDescription
idHEX (32 Bytes)The id of the account for which the sync job meta info has to be retrieved.

Returns:​

Return TypeDescription
OBJECTThe object contains the sync job meta info for given id
  curl --location 'http://localhost:1600/' \
  --header 'Content-Type: application/json' \
  --data '{
      "method": "debug.SyncJob",
      "params": [
          {
              "id": "0x52fdfc072182654f163f5f0f9a621d729566c74d10037c4d7bbb0407d1e2c649"
          }
      ],
      "jsonrpc": "2.0",
      "id": 1
  }'