In Aleo, full nodes run a JSON-RPC server to enable API calls for fetching data and interacting with peers connected to the network.
ignore
-rpc-port 3030
The default RPC port is 3030. This can be specified with the -rpc-port flag when starting a full node.
ignore
-rpc-username {USERNAME} -rpc-password {PASSWORD}
The RPC server exposes protected RPC endpoints for account specific operations, such as creating an account, creating a transaction, and fetching record commitments. RPC requests to protected RPC endpoints can be optionally guarded with an authentication header.
To enable this authentication layer, provide the authentication credentials to
the -rpc-username and -rpc-password flags when booting up a full node.
Returns information about a transaction from serialized transaction bytes.
| Parameter | Type | Required | Description |
|:------------------- |:------:|:--------:|:--------------------------------- |
| transaction_bytes | string | Yes | The raw transaction hex to decode |
| Parameter | Type | Description |
|:-----------------------:|:------:|:----------------------------------------- |
| txid | string | The transaction id |
| size | number | The size of the transaction in bytes |
| old_serial_numbers | array | The list of old record serial numbers |
| new_commitments | array | The list of new record commitments |
| memo | string | The transaction memo |
| network_id | number | The transaction network id |
| digest | string | The merkle tree digest |
| transaction_proof | string | The transaction zero knowledge proof |
| program_commitment | string | The program verification key commitment |
| local_data_root | string | The local data root |
| value balance | number | The transaction value balance |
| signatures | array | The list of transaction signatures |
| transaction_metadata | object | The transaction metadata |
ignore
curl --data-binary '{"jsonrpc": "2.0", "id":"documentation", "method": "decoderawtransaction", "params": ["transaction_hexstring"] }' -H 'content-type: application/json' http://127.0.0.1:3030/
Returns the block hash of the head of the best valid chain.
None
| Parameter | Type | Description |
|:---------:|:------:|:---------------------------------------------:|
| result | string | The block hash of the most recent valid block |
ignore
curl --data-binary '{"jsonrpc": "2.0", "id":"documentation", "method": "getbestblockhash", "params": [] }' -H 'content-type: application/json' http://127.0.0.1:3030/
Returns information about a block from a block hash.
| Parameter | Type | Required | Description |
|:------------ |:------:|:--------:|:------------------------------------- |
| block_hash | string | Yes | The block hash of the requested block |
| Parameter | Type | Description |
|:----------------------:|:------:|:----------------------------------------------------------------------:|
| confirmations | number | The number of confirmations for this block |
| difficulty_target | number | The difficulty of the block |
| hash | string | The block hash (same as provided) |
| height | number | The block height |
| merkle_root | number | The Merkle root of the transactions in the block |
| nonce | number | The nonce for solving the PoSW puzzle |
| pedersen_merkle_root | number | The Merkle root of the transactions in the block using a Pedersen hash |
| previous_block_hash | string | The block hash of the parent block |
| proof | string | The Proof of Succinct Work |
| size | number | The size of the block in bytes |
| time | number | The block time |
| transactions | array | The list of transaction ids included in the block |
ignore
curl --data-binary '{"jsonrpc": "2.0", "id":"documentation", "method": "getblock", "params": ["caf49293d36f0215cfb3296dbc871a0ef5e5dcfc61f91cd0c9ac2c730f84d853"] }' -H 'content-type: application/json' http://127.0.0.1:3030/
Returns the number of blocks in the best valid chain.
None
| Parameter | Type | Description |
|:---------:|:------:|:--------------------------------------------:|
| result | string | The number of blocks in the best valid chain |
ignore
curl --data-binary '{"jsonrpc": "2.0", "id":"documentation", "method": "getblockcount", "params": [] }' -H 'content-type: application/json' http://127.0.0.1:3030/
Returns the block hash of a block at the given block height in the best valid chain.
| Parameter | Type | Required | Description |
|:-------------- |:------:|:--------:|:-------------------------------------------- |
| block_height | string | Yes | The block height of the requested block hash |
| Parameter | Type | Description |
|:---------:|:------:|:-----------------------------------------------------:|
| result | string | The block hash of the block at the given block height |
ignore
curl --data-binary '{"jsonrpc": "2.0", "id":"documentation", "method": "getblockhash", "params": [100] }' -H 'content-type: application/json' http://127.0.0.1:3030/
Returns the current mempool and consensus information known by this node.
None
| Parameter | Type | Description |
|:--------------------- |:------:|:----------------------------------------------------- |
| previous_block_hash | string | The hash of current highest block |
| block_height | number | The height of the next block |
| time | number | The current timestamp |
| difficulty_target | number | The block difficulty target |
| transactions | array | The list of raw transactions to include in the block |
| coinbase_value | number | The amount spendable by the coinbase transaction |
ignore
curl --data-binary '{"jsonrpc": "2.0", "id":"documentation", "method": "getblocktemplate", "params": [] }' -H 'content-type: application/json' http://127.0.0.1:3030/
Returns the number of connected peers this node has.
None
| Parameter | Type | Description |
|:---------:|:------:|:----------------------------- |
| result | number | The number of connected nodes |
ignore
curl --data-binary '{"jsonrpc": "2.0", "id":"documentation", "method": "getconnectioncount", "params": [] }' -H 'content-type: application/json' http://127.0.0.1:3030/
Returns the node's connected peers.
None
| Parameter | Type | Description |
|:---------:|:-----:|:------------------------------:|
| peers | array | The list of connected peer IPs |
ignore
curl --data-binary '{"jsonrpc": "2.0", "id":"documentation", "method": "getpeerinfo", "params": [] }' -H 'content-type: application/json' http://127.0.0.1:3030/
Returns hex encoded bytes of a transaction from its transaction id.
| Parameter | Type | Required | Description |
|:---------------- |:------:|:--------:|:--------------------------------------------------- |
| transaction_id | string | Yes | The transaction id of the requested transaction hex |
| Parameter | Type | Description |
|:---------:|:------:|:---------------------------------:|
| result | string | The hex-encoded transaction bytes |
ignore
curl --data-binary '{"jsonrpc": "2.0", "id":"documentation", "method": "getrawtransaction", "params": ["83fc73b8a104d7cdabe514ec4ddfeb7fd6284ff8e0a757d25d8479ed0ffe608b"] }' -H 'content-type: application/json' http://127.0.0.1:3030/
Returns information about a transaction from a transaction id.
| Parameter | Type | Required | Description |
|:---------------- |:------:|:--------:|:---------------------------------------------------- |
| transaction_id | string | Yes | The transaction id of the requested transaction info |
| Parameter | Type | Description |
|:-----------------------:|:------:|:---------------------------------------- |
| txid | string | The transaction id |
| size | number | The size of the transaction in bytes |
| old_serial_numbers | array | The list of old record serial numbers |
| new_commitments | array | The list of new record commitments |
| memo | string | The transaction memo |
| digest | string | The merkle tree digest |
| transaction_proof | string | The transaction zero knowledge proof |
| program_commitment | string | The program verification key commitment |
| local_data_root | string | The local data root |
| value balance | number | The transaction value balance |
| signatures | array | The list of transaction signatures |
| transaction_metadata | object | The transaction metadata |
ignore
curl --data-binary '{"jsonrpc": "2.0", "id":"documentation", "method": "gettransactioninfo", "params": ["83fc73b8a104d7cdabe514ec4ddfeb7fd6284ff8e0a757d25d8479ed0ffe608b"] }' -H 'content-type: application/json' http://127.0.0.1:3030/
Send raw transaction bytes to this node to be added into the mempool. If valid, the transaction will be stored and propagated to all peers.
| Parameter | Type | Required | Description |
|:------------------- |:------:|:--------:|:------------------------------------ |
| transaction_bytes | string | Yes | The raw transaction hex to broadcast |
| Parameter | Type | Description |
|:---------:|:------:|:------------------------------------------ |
| result | string | The transaction id of the sent transaction |
ignore
curl --data-binary '{"jsonrpc": "2.0", "id":"documentation", "method": "sendtransaction", "params": ["transaction_hexstring"] }' -H 'content-type: application/json' http://127.0.0.1:3030/
Validate and return if the transaction is valid.
| Parameter | Type | Required | Description |
|:------------------- |:------:|:--------:|:----------------------------------- |
| transaction_bytes | string | Yes | The raw transaction hex to validate |
| Parameter | Type | Description |
|:---------:|:-------:|:----------------------------------- |
| result | boolean | Check that the transaction is valid |
ignore
curl --data-binary '{"jsonrpc": "2.0", "id":"documentation", "method": "validaterawtransaction", "params": ["transaction_hexstring"] }' -H 'content-type: application/json' http://127.0.0.1:3030/
Generate a new account private key and its corresponding account address.
Yes
None
| Parameter | Type | Description |
|:------------- |:------:|:--------------------------- |
| private_key | string | An Aleo account private key |
| address | string | An Aleo account address |
ignore
curl --user username:password --data-binary '{"jsonrpc": "2.0", "id":"documentation", "method": "createaccount", "params": [] }' -H 'content-type: application/json' http://127.0.0.1:3030/
Create a new transaction, returning the encoded transaction and the new records.
Yes
| Parameter | Type | Required | Description |
|:-------------------------- |:------:|:--------:|:-------------------------------------------------------- |
| old_records | array | Yes | An array of hex encoded records to be spent |
| old_account_private_keys | array | Yes | An array of private keys authorized to spend the records |
| recipients | array | Yes | The array of transaction recipient objects |
| memo | string | No | The transaction memo |
| network_id | number | Yes | The network id of the transaction |
Transaction Recipient Object
| Parameter | Type | Description |
|:---------:|:------:|:--------------------------------:|
| address | string | The recipient address |
| value | number | The amount sent to the recipient |
| Parameter | Type | Description |
|:---------------------:|:------:|:--------------------------------------------- |
| encoded_transaction | string | The hex encoding of the generated transaction |
| encoded_records | array | The hex encodings of the generated records |
ignore
curl --user username:password --data-binary '{
"jsonrpc":"2.0",
"id": "1",
"method": "createrawtransaction",
"params": [
{
"old_records": ["record_hexstring"],
"old_account_private_keys": ["private_key_string"],
"recipients": [{
"address": "address_string",
"amount": amount
}],
"memo": "memo_hexstring",
"network_id": 0
}
]
}' -H 'content-type: application/json' http://127.0.0.1:3030/
Returns information about a record from serialized record hex.
| Parameter | Type | Required | Description |
|:--------------:|:------:|:--------:|:----------------------------:|
| record_bytes | string | Yes | The raw record hex to decode |
| Parameter | Type | Description |
|:-----------------------:|:------:|:---------------------------------:|
| owner | string | The owner of the record |
| is_dummy | number | The height of the next block |
| value | number | The current timestamp |
| payload | object | The record payload |
| birth_program_id | string | The birth program representation |
| death_program_id | string | The death program representation |
| serial_number_nonce | string | The serial number nonce |
| commitment | string | The record commitment |
| commitment_randomness | string | The record commitment randomness |
ignore
curl --data-binary '{"jsonrpc": "2.0", "id":"documentation", "method": "decoderecord", "params": ["record_hexstring"] }' -H 'content-type: application/json' http://127.0.0.1:3030/
Decrypts the encrypted record and returns the hex encoded bytes of the record.
| Parameter | Type | Required | Description |
|:-------------------:|:------:|:--------:|:---------------------------------------------------:|
| encrypted_record | string | Yes | The encrypted record |
| account_view_key | string | Yes | The account view key used to decrypt the ciphertext |
| Parameter | Type | Description |
|:---------:|:------:|:---------------------------- |
| result | string | The hex-encoded record bytes |
ignore
curl --user username:password --data-binary '{
"jsonrpc":"2.0",
"id": "1",
"method": "decryptrecord",
"params": [
{
"encrypted_record": "encrypted_record_string",
"account_view_key": "account_view_key_string"
}
]
}' -H 'content-type: application/json' http://127.0.0.1:3030/
Returns the hex encoded bytes of a record from its record commitment.
Yes
| Parameter | Type | Required | Description |
|:-------------------:|:------:|:--------:|:--------------------- |
| record_commitment | string | Yes | The record commitment |
| Parameter | Type | Description |
|:---------:|:------:|:---------------------------- |
| result | string | The hex-encoded record bytes |
ignore
curl --user username:password --data-binary '{"jsonrpc": "2.0", "id":"documentation", "method": "getrawrecord", "params": ["86be61d5f3bd795e31615d6834efefca01ad023d57c0383e2231e094bcabfc05"] }' -H 'content-type: application/json' http://127.0.0.1:3030/
Returns the number of record commitments that are stored on the full node.
Yes
None
| Parameter | Type | Description |
|:---------:|:------:|:--------------------------------------- |
| result | number | The number of stored record commitments |
ignore
curl --user username:password --data-binary '{"jsonrpc": "2.0", "id":"documentation", "method": "getrecordcommitmentcount", "params": [] }' -H 'content-type: application/json' http://127.0.0.1:3030/
Returns a list of record commitments that are stored on the full node.
Yes
None
| Parameter | Type | Description |
|:---------:|:-----:|:------------------------------------- |
| result | array | The list of stored record commitments |
ignore
curl --user username:password --data-binary '{"jsonrpc": "2.0", "id":"documentation", "method": "getrecordcommitments", "params": [] }' -H 'content-type: application/json' http://127.0.0.1:3030/
This README is auto-generated during continuous integration. To update this README, submit a pull request updating the appropriate Markdown file in documentation and the configuration file.