JSON-RPC API Reference

Each node in the Pactus network can be configured to use the JSON-RPC protocol for communication. Here, you can find the list of all JSON-RPC methods and messages.

All the amounts and values in JSON-RPC endpoints are in NanoPAC units, which are atomic and the smallest unit in the Pactus blockchain. Each PAC is equivalent to 1,000,000,000 or 10⁹ NanoPACs.

Example

To call JSON-RPC methods, you need to create the JSON-RPC request:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "pactus.network.get_node_info",
  "params": {}
}

Make sure you always add the params field, even if no parameters are needed, and ensure you use curly braces.

Then you use the curl command to send the request to the node:

curl --location 'http://localhost:8545/' \
--header 'Content-Type: application/json' \
--data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "pactus.network.get_node_info",
    "params": {}
}'

Before sending the request, you need to enable the JSON-RPC service inside the configuration.

Using Basic Auth

If you have enabled the gRPC Basic Authentication, then you need to set the Authorization header.

curl --location 'http://localhost:8545/' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic <BASIC-AUTH-TOKEN>' \
--data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "pactus.blockchain.get_account",
    "params": {
        "address": "pc1z2r0fmu8sg2ffa0tgrr08gnefcxl2kq7wvquf8z"
    }
}'

JSON-RPC Methods

Transaction Service
Blockchain Service
Network Service
- pactus.network.get_network_info
- pactus.network.get_node_info
Utils Service
- pactus.utils.sign_message_with_private_key
- pactus.utils.verify_message
Wallet Service

Transaction Service

Transaction service defines various RPC methods for interacting with transactions.

pactus.transaction.get_transaction

GetTransaction retrieves transaction details based on the provided request parameters.

Parameters

Field	Type	Description
id	string	The unique ID of the transaction to retrieve.
verbosity	numeric	(Enum)The verbosity level for transaction details. Available values: TRANSACTION_DATA = 0 (Request transaction data only.) TRANSACTION_INFO = 1 (Request detailed transaction information.)

Result

Field	Type	Description
block_height	numeric	The height of the block containing the transaction.
block_time	numeric	The UNIX timestamp of the block containing the transaction.
transaction	object	Detailed information about the transaction.
transaction.id	string	The unique ID of the transaction.
transaction.data	string	The raw transaction data.
transaction.version	numeric	The version of the transaction.
transaction.lock_time	numeric	The lock time for the transaction.
transaction.value	numeric	The value of the transaction in NanoPAC.
transaction.fee	numeric	The fee for the transaction in NanoPAC.
transaction.payload_type	numeric	(Enum)The type of transaction payload. Available values: UNKNOWN = 0 (Unknown payload type.) TRANSFER_PAYLOAD = 1 (Transfer payload type.) BOND_PAYLOAD = 2 (Bond payload type.) SORTITION_PAYLOAD = 3 (Sortition payload type.) UNBOND_PAYLOAD = 4 (Unbond payload type.) WITHDRAW_PAYLOAD = 5 (Withdraw payload type.)
transaction.transfer	object	(OneOf)Transfer transaction payload.
transaction.transfer.sender	string	The sender's address.
transaction.transfer.receiver	string	The receiver's address.
transaction.transfer.amount	numeric	The amount to be transferred in NanoPAC.
transaction.bond	object	(OneOf)Bond transaction payload.
transaction.bond.sender	string	The sender's address.
transaction.bond.receiver	string	The receiver's address.
transaction.bond.stake	numeric	The stake amount in NanoPAC.
transaction.bond.public_key	string	The public key of the validator.
transaction.sortition	object	(OneOf)Sortition transaction payload.
transaction.sortition.address	string	The validator address associated with the sortition proof.
transaction.sortition.proof	string	The proof for the sortition.
transaction.unbond	object	(OneOf)Unbond transaction payload.
transaction.unbond.validator	string	The address of the validator to unbond from.
transaction.withdraw	object	(OneOf)Withdraw transaction payload.
transaction.withdraw.validator_address	string	The address of the validator to withdraw from.
transaction.withdraw.account_address	string	The address of the account to withdraw to.
transaction.withdraw.amount	numeric	The withdrawal amount in NanoPAC.
transaction.memo	string	A memo string for the transaction.
transaction.public_key	string	The public key associated with the transaction.
transaction.signature	string	The signature for the transaction.

pactus.transaction.calculate_fee

CalculateFee calculates the transaction fee based on the specified amount and payload type.

Parameters

Field	Type	Description
amount	numeric	The amount involved in the transaction, specified in NanoPAC.
payload_type	numeric	(Enum)The type of transaction payload. Available values: UNKNOWN = 0 (Unknown payload type.) TRANSFER_PAYLOAD = 1 (Transfer payload type.) BOND_PAYLOAD = 2 (Bond payload type.) SORTITION_PAYLOAD = 3 (Sortition payload type.) UNBOND_PAYLOAD = 4 (Unbond payload type.) WITHDRAW_PAYLOAD = 5 (Withdraw payload type.)
fixed_amount	boolean	Indicates if the amount should be fixed and include the fee.

Result

Field	Type	Description
amount	numeric	The calculated amount in NanoPAC.
fee	numeric	The calculated transaction fee in NanoPAC.

pactus.transaction.broadcast_transaction

BroadcastTransaction broadcasts a signed transaction to the network.

Parameters

Field	Type	Description
signed_raw_transaction	string	The signed raw transaction data to be broadcasted.

Result

Field	Type	Description
id	string	The unique ID of the broadcasted transaction.

pactus.transaction.get_raw_transaction

GetRawTransaction retrieves raw details of transfer, bond, unbond or withdraw transaction.

Parameters

Field	Type	Description
lock_time	numeric	The lock time for the transaction. If not set, defaults to the last block height.
memo	string	A memo string for the transaction.
fee	numeric	The fee for the transaction in NanoPAC.
transfer	object	(OneOf)
bond	object	(OneOf)
unbond	object	(OneOf)
withdraw	object	(OneOf)

Result

Field	Type	Description
raw_transaction	string	The raw transaction data.
id	string	The unique ID of the transaction.

pactus.transaction.get_raw_transfer_transaction

Deprecated: GetRawTransferTransaction retrieves raw details of a transfer transaction. Use GetRawTransaction instead.

Parameters

Field	Type	Description
lock_time	numeric	The lock time for the transaction. If not set, defaults to the last block height.
sender	string	The sender's account address.
receiver	string	The receiver's account address.
amount	numeric	The amount to be transferred, specified in NanoPAC. Must be greater than 0.
fee	numeric	The transaction fee in NanoPAC. If not set, it is set to the estimated fee.
memo	string	A memo string for the transaction.

Result

Field	Type	Description
raw_transaction	string	The raw transaction data.
id	string	The unique ID of the transaction.

pactus.transaction.get_raw_bond_transaction

Deprecated: GetRawBondTransaction retrieves raw details of a bond transaction. Use GetRawTransaction instead.

Parameters

Field	Type	Description
lock_time	numeric	The lock time for the transaction. If not set, defaults to the last block height.
sender	string	The sender's account address.
receiver	string	The receiver's validator address.
stake	numeric	The stake amount in NanoPAC. Must be greater than 0.
public_key	string	The public key of the validator.
fee	numeric	The transaction fee in NanoPAC. If not set, it is set to the estimated fee.
memo	string	A memo string for the transaction.

Result

Field	Type	Description
raw_transaction	string	The raw transaction data.
id	string	The unique ID of the transaction.

pactus.transaction.get_raw_unbond_transaction

Deprecated: GetRawUnbondTransaction retrieves raw details of an unbond transaction. Use GetRawTransaction instead.

Parameters

Field	Type	Description
lock_time	numeric	The lock time for the transaction. If not set, defaults to the last block height.
validator_address	string	The address of the validator to unbond from.
memo	string	A memo string for the transaction.

Result

Field	Type	Description
raw_transaction	string	The raw transaction data.
id	string	The unique ID of the transaction.

pactus.transaction.get_raw_withdraw_transaction

Deprecated: GetRawWithdrawTransaction retrieves raw details of a withdraw transaction. Use GetRawTransaction instead.

Parameters

Field	Type	Description
lock_time	numeric	The lock time for the transaction. If not set, defaults to the last block height.
validator_address	string	The address of the validator to withdraw from.
account_address	string	The address of the account to withdraw to.
amount	numeric	The withdrawal amount in NanoPAC. Must be greater than 0.
fee	numeric	The transaction fee in NanoPAC. If not set, it is set to the estimated fee.
memo	string	A memo string for the transaction.

Result

Field	Type	Description
raw_transaction	string	The raw transaction data.
id	string	The unique ID of the transaction.

Blockchain Service

Blockchain service defines RPC methods for interacting with the blockchain.

pactus.blockchain.get_block

GetBlock retrieves information about a block based on the provided request parameters.

Parameters

Field	Type	Description
height	numeric	The height of the block to retrieve.
verbosity	numeric	(Enum)The verbosity level for block information. Available values: BLOCK_DATA = 0 (Request only block data.) BLOCK_INFO = 1 (Request block information and transaction IDs.) BLOCK_TRANSACTIONS = 2 (Request block information and detailed transaction data.)

Result

Field	Type	Description
height	numeric	The height of the block.
hash	string	The hash of the block.
data	string	Block data, available only if verbosity level is set to BLOCK_DATA.
block_time	numeric	The timestamp of the block.
header	object	Header information of the block.
header.version	numeric	The version of the block.
header.prev_block_hash	string	The hash of the previous block.
header.state_root	string	The state root hash of the blockchain.
header.sortition_seed	string	The sortition seed of the block.
header.proposer_address	string	The address of the proposer of the block.
prev_cert	object	Certificate information of the previous block.
prev_cert.hash	string	The hash of the certificate.
prev_cert.round	numeric	The round of the certificate.
prev_cert.committers	repeated numeric	List of committers in the certificate.
prev_cert.absentees	repeated numeric	List of absentees in the certificate.
prev_cert.signature	string	The signature of the certificate.
txs	repeated object	List of transactions in the block, available when verbosity level is set to BLOCK_TRANSACTIONS.
txs[].id	string	The unique ID of the transaction.
txs[].data	string	The raw transaction data.
txs[].version	numeric	The version of the transaction.
txs[].lock_time	numeric	The lock time for the transaction.
txs[].value	numeric	The value of the transaction in NanoPAC.
txs[].fee	numeric	The fee for the transaction in NanoPAC.
txs[].payload_type	numeric	(Enum)The type of transaction payload. Available values: UNKNOWN = 0 (Unknown payload type.) TRANSFER_PAYLOAD = 1 (Transfer payload type.) BOND_PAYLOAD = 2 (Bond payload type.) SORTITION_PAYLOAD = 3 (Sortition payload type.) UNBOND_PAYLOAD = 4 (Unbond payload type.) WITHDRAW_PAYLOAD = 5 (Withdraw payload type.)
txs[].transfer	object	(OneOf)Transfer transaction payload.
txs[].transfer.sender	string	The sender's address.
txs[].transfer.receiver	string	The receiver's address.
txs[].transfer.amount	numeric	The amount to be transferred in NanoPAC.
txs[].bond	object	(OneOf)Bond transaction payload.
txs[].bond.sender	string	The sender's address.
txs[].bond.receiver	string	The receiver's address.
txs[].bond.stake	numeric	The stake amount in NanoPAC.
txs[].bond.public_key	string	The public key of the validator.
txs[].sortition	object	(OneOf)Sortition transaction payload.
txs[].sortition.address	string	The validator address associated with the sortition proof.
txs[].sortition.proof	string	The proof for the sortition.
txs[].unbond	object	(OneOf)Unbond transaction payload.
txs[].unbond.validator	string	The address of the validator to unbond from.
txs[].withdraw	object	(OneOf)Withdraw transaction payload.
txs[].withdraw.validator_address	string	The address of the validator to withdraw from.
txs[].withdraw.account_address	string	The address of the account to withdraw to.
txs[].withdraw.amount	numeric	The withdrawal amount in NanoPAC.
txs[].memo	string	A memo string for the transaction.
txs[].public_key	string	The public key associated with the transaction.
txs[].signature	string	The signature for the transaction.

pactus.blockchain.get_block_hash

GetBlockHash retrieves the hash of a block at the specified height.

Parameters

Field	Type	Description
height	numeric	The height of the block to retrieve the hash for.

Result

Field	Type	Description
hash	string	The hash of the block.

pactus.blockchain.get_block_height

GetBlockHeight retrieves the height of a block with the specified hash.

Parameters

Field	Type	Description
hash	string	The hash of the block to retrieve the height for.

Result

Field	Type	Description
height	numeric	The height of the block.

pactus.blockchain.get_blockchain_info

GetBlockchainInfo retrieves general information about the blockchain.

Parameters

Parameters has no fields.

Result

Field	Type	Description
last_block_height	numeric	The height of the last block in the blockchain.
last_block_hash	string	The hash of the last block in the blockchain.
total_accounts	numeric	The total number of accounts in the blockchain.
total_validators	numeric	The total number of validators in the blockchain.
total_power	numeric	The total power of the blockchain.
committee_power	numeric	The power of the committee.
committee_validators	repeated object	List of committee validators.
committee_validators[].hash	string	The hash of the validator.
committee_validators[].data	string	The serialized data of the validator.
committee_validators[].public_key	string	The public key of the validator.
committee_validators[].number	numeric	The unique number assigned to the validator.
committee_validators[].stake	numeric	The stake of the validator in NanoPAC.
committee_validators[].last_bonding_height	numeric	The height at which the validator last bonded.
committee_validators[].last_sortition_height	numeric	The height at which the validator last participated in sortition.
committee_validators[].unbonding_height	numeric	The height at which the validator will unbond.
committee_validators[].address	string	The address of the validator.
committee_validators[].availability_score	numeric	The availability score of the validator.
is_pruned	boolean	If the blocks are subject to pruning.
pruning_height	numeric	Lowest-height block stored (only present if pruning is enabled)
last_block_time	numeric	Timestamp of the last block in Unix format

pactus.blockchain.get_consensus_info

GetConsensusInfo retrieves information about the consensus instances.

Parameters

Parameters has no fields.

Result

Field	Type	Description
proposal	object	The proposal of the consensus info.
proposal.height	numeric	The height of the proposal.
proposal.round	numeric	The round of the proposal.
proposal.block_data	string	The block data of the proposal.
proposal.signature	string	The signature of the proposal, signed by the proposer.
instances	repeated object	List of consensus instances.
instances[].address	string	The address of the consensus instance.
instances[].active	boolean	Indicates whether the consensus instance is active and part of the committee.
instances[].height	numeric	The height of the consensus instance.
instances[].round	numeric	The round of the consensus instance.
instances[].votes	repeated object	List of votes in the consensus instance.
instances[].votes[].type	numeric	(Enum)The type of the vote. Available values: VOTE_UNKNOWN = 0 (Unknown vote type.) VOTE_PREPARE = 1 (Prepare vote type.) VOTE_PRECOMMIT = 2 (Precommit vote type.) VOTE_CHANGE_PROPOSER = 3 (Change proposer vote type.)
instances[].votes[].voter	string	The address of the voter.
instances[].votes[].block_hash	string	The hash of the block being voted on.
instances[].votes[].round	numeric	The consensus round of the vote.
instances[].votes[].cp_round	numeric	The change-proposer round of the vote.
instances[].votes[].cp_value	numeric	The change-proposer value of the vote.

pactus.blockchain.get_account

GetAccount retrieves information about an account based on the provided address.

Parameters

Field	Type	Description
address	string	The address of the account to retrieve information for.

Result

Field	Type	Description
account	object	Detailed information about the account.
account.hash	string	The hash of the account.
account.data	string	The serialized data of the account.
account.number	numeric	The unique number assigned to the account.
account.balance	numeric	The balance of the account in NanoPAC.
account.address	string	The address of the account.

pactus.blockchain.get_validator

GetValidator retrieves information about a validator based on the provided address.

Parameters

Field	Type	Description
address	string	The address of the validator to retrieve information for.

Result

Field	Type	Description
validator	object	Detailed information about the validator.
validator.hash	string	The hash of the validator.
validator.data	string	The serialized data of the validator.
validator.public_key	string	The public key of the validator.
validator.number	numeric	The unique number assigned to the validator.
validator.stake	numeric	The stake of the validator in NanoPAC.
validator.last_bonding_height	numeric	The height at which the validator last bonded.
validator.last_sortition_height	numeric	The height at which the validator last participated in sortition.
validator.unbonding_height	numeric	The height at which the validator will unbond.
validator.address	string	The address of the validator.
validator.availability_score	numeric	The availability score of the validator.

pactus.blockchain.get_validator_by_number

GetValidatorByNumber retrieves information about a validator based on the provided number.

Parameters

Field	Type	Description
number	numeric	The unique number of the validator to retrieve information for.

Result

Field	Type	Description
validator	object	Detailed information about the validator.
validator.hash	string	The hash of the validator.
validator.data	string	The serialized data of the validator.
validator.public_key	string	The public key of the validator.
validator.number	numeric	The unique number assigned to the validator.
validator.stake	numeric	The stake of the validator in NanoPAC.
validator.last_bonding_height	numeric	The height at which the validator last bonded.
validator.last_sortition_height	numeric	The height at which the validator last participated in sortition.
validator.unbonding_height	numeric	The height at which the validator will unbond.
validator.address	string	The address of the validator.
validator.availability_score	numeric	The availability score of the validator.

pactus.blockchain.get_validator_addresses

GetValidatorAddresses retrieves a list of all validator addresses.

Parameters

Parameters has no fields.

Result

Field	Type	Description
addresses	repeated string	List of validator addresses.

pactus.blockchain.get_public_key

GetPublicKey retrieves the public key of an account based on the provided address.

Parameters

Field	Type	Description
address	string	The address for which to retrieve the public key.

Result

Field	Type	Description
public_key	string	The public key associated with the provided address.

pactus.blockchain.get_tx_pool_content

GetTxPoolContent retrieves current transactions in the transaction pool.

Parameters

Field	Type	Description
payload_type	numeric	(Enum)The type of transactions to retrieve from the transaction pool. 0 means all types. Available values: UNKNOWN = 0 (Unknown payload type.) TRANSFER_PAYLOAD = 1 (Transfer payload type.) BOND_PAYLOAD = 2 (Bond payload type.) SORTITION_PAYLOAD = 3 (Sortition payload type.) UNBOND_PAYLOAD = 4 (Unbond payload type.) WITHDRAW_PAYLOAD = 5 (Withdraw payload type.)

Result

Field	Type	Description
txs	repeated object	List of transactions currently in the pool.
txs[].id	string	The unique ID of the transaction.
txs[].data	string	The raw transaction data.
txs[].version	numeric	The version of the transaction.
txs[].lock_time	numeric	The lock time for the transaction.
txs[].value	numeric	The value of the transaction in NanoPAC.
txs[].fee	numeric	The fee for the transaction in NanoPAC.
txs[].payload_type	numeric	(Enum)The type of transaction payload. Available values: UNKNOWN = 0 (Unknown payload type.) TRANSFER_PAYLOAD = 1 (Transfer payload type.) BOND_PAYLOAD = 2 (Bond payload type.) SORTITION_PAYLOAD = 3 (Sortition payload type.) UNBOND_PAYLOAD = 4 (Unbond payload type.) WITHDRAW_PAYLOAD = 5 (Withdraw payload type.)
txs[].transfer	object	(OneOf)Transfer transaction payload.
txs[].transfer.sender	string	The sender's address.
txs[].transfer.receiver	string	The receiver's address.
txs[].transfer.amount	numeric	The amount to be transferred in NanoPAC.
txs[].bond	object	(OneOf)Bond transaction payload.
txs[].bond.sender	string	The sender's address.
txs[].bond.receiver	string	The receiver's address.
txs[].bond.stake	numeric	The stake amount in NanoPAC.
txs[].bond.public_key	string	The public key of the validator.
txs[].sortition	object	(OneOf)Sortition transaction payload.
txs[].sortition.address	string	The validator address associated with the sortition proof.
txs[].sortition.proof	string	The proof for the sortition.
txs[].unbond	object	(OneOf)Unbond transaction payload.
txs[].unbond.validator	string	The address of the validator to unbond from.
txs[].withdraw	object	(OneOf)Withdraw transaction payload.
txs[].withdraw.validator_address	string	The address of the validator to withdraw from.
txs[].withdraw.account_address	string	The address of the account to withdraw to.
txs[].withdraw.amount	numeric	The withdrawal amount in NanoPAC.
txs[].memo	string	A memo string for the transaction.
txs[].public_key	string	The public key associated with the transaction.
txs[].signature	string	The signature for the transaction.

Network Service

Network service provides RPCs for retrieving information about the network.

pactus.network.get_network_info

GetNetworkInfo retrieves information about the overall network.

Parameters

Field	Type	Description
only_connected	boolean	If true, returns only peers that are currently connected.

Result

Field	Type	Description
network_name	string	Name of the network.
connected_peers_count	numeric	Number of connected peers.
connected_peers	repeated object	List of connected peers.
connected_peers[].status	numeric	Current status of the peer (e.g., connected, disconnected).
connected_peers[].moniker	string	Moniker of the peer.
connected_peers[].agent	string	Version and agent details of the peer.
connected_peers[].peer_id	string	Peer ID of the peer.
connected_peers[].consensus_keys	repeated string	List of consensus keys used by the peer.
connected_peers[].consensus_addresses	repeated string	List of consensus addresses used by the peer.
connected_peers[].services	numeric	Bitfield representing the services provided by the peer.
connected_peers[].last_block_hash	string	Hash of the last block the peer knows.
connected_peers[].height	numeric	Blockchain height of the peer.
connected_peers[].last_sent	numeric	Time the last bundle sent to the peer (in epoch format).
connected_peers[].last_received	numeric	Time the last bundle received from the peer (in epoch format).
connected_peers[].address	string	Network address of the peer.
connected_peers[].direction	string	Connection direction (e.g., inbound, outbound).
connected_peers[].protocols	repeated string	List of protocols supported by the peer.
connected_peers[].total_sessions	numeric	Total download sessions with the peer.
connected_peers[].completed_sessions	numeric	Completed download sessions with the peer.
connected_peers[].metric_info	object	Metrics related to peer activity.
connected_peers[].metric_info.TotalInvalid	object	Total number of invalid bundles.
connected_peers[].metric_info.TotalSent	object	Total number of bundles sent.
connected_peers[].metric_info.TotalReceived	object	Total number of bundles received.
connected_peers[].metric_info.MessageSent	object	Number of sent bundles categorized by message type.
connected_peers[].metric_info.MessageReceived	object	Number of received bundles categorized by message type.
metric_info	object	Metrics related to node activity.
metric_info.TotalInvalid	object	Total number of invalid bundles.
metric_info.TotalInvalid.Bytes	numeric	Total number of bytes.
metric_info.TotalInvalid.Bundles	numeric	Total number of bundles.
metric_info.TotalSent	object	Total number of bundles sent.
metric_info.TotalSent.Bytes	numeric	Total number of bytes.
metric_info.TotalSent.Bundles	numeric	Total number of bundles.
metric_info.TotalReceived	object	Total number of bundles received.
metric_info.TotalReceived.Bytes	numeric	Total number of bytes.
metric_info.TotalReceived.Bundles	numeric	Total number of bundles.
metric_info.MessageSent	object	Number of sent bundles categorized by message type.
metric_info.MessageReceived	object	Number of received bundles categorized by message type.

pactus.network.get_node_info

GetNodeInfo retrieves information about a specific node in the network.

Parameters

Parameters has no fields.

Result

Field	Type	Description
moniker	string	Moniker of the node.
agent	string	Version and agent details of the node.
peer_id	string	Peer ID of the node.
started_at	numeric	Time the node was started (in epoch format).
reachability	string	Reachability status of the node.
services	numeric	Bitfield representing the services provided by the node.
services_names	string	Names of services provided by the node.
local_addrs	repeated string	List of addresses associated with the node.
protocols	repeated string	List of protocols supported by the node.
clock_offset	numeric	Offset between the node's clock and the network's clock (in seconds).
connection_info	object	Information about the node's connections.
connection_info.connections	numeric	Total number of connections.
connection_info.inbound_connections	numeric	Number of inbound connections.
connection_info.outbound_connections	numeric	Number of outbound connections.

Utils Service

Utils service defines RPC methods for utility functions such as message signing and verification.

pactus.utils.sign_message_with_private_key

SignMessageWithPrivateKey sign message with provided private key.

Parameters

Field	Type	Description
private_key	string	The private key to sign the message.
message	string	The message to sign.

Result

Field	Type	Description
signature	string	The signature of the message.

pactus.utils.verify_message

VerifyMessage verify signature with public key and message

Parameters

Field	Type	Description
message	string	The signed message.
signature	string	The signature of the message.
public_key	string	The public key of the signer.

Result

Field	Type	Description
is_valid	boolean	Indicates if the signature is valid (true) or not (false).

Wallet Service

Define the Wallet service with various RPC methods for wallet management.

pactus.wallet.create_wallet

CreateWallet creates a new wallet with the specified parameters.

Parameters

Field	Type	Description
wallet_name	string	The name of the new wallet.
password	string	The password for securing the wallet.

Result

Field	Type	Description
mnemonic	string	The mnemonic for wallet recovery.

pactus.wallet.restore_wallet

RestoreWallet restores an existing wallet with the given mnemonic.

Parameters

Field	Type	Description
wallet_name	string	The name of the wallet to restore.
mnemonic	string	The mnemonic for wallet recovery.
password	string	The password for securing the wallet.

Result

Field	Type	Description
wallet_name	string	The name of the restored wallet.

pactus.wallet.load_wallet

LoadWallet loads an existing wallet with the given name.

Parameters

Field	Type	Description
wallet_name	string	The name of the wallet to load.

Result

Field	Type	Description
wallet_name	string	The name of the loaded wallet.

pactus.wallet.unload_wallet

UnloadWallet unloads a currently loaded wallet with the specified name.

Parameters

Field	Type	Description
wallet_name	string	The name of the wallet to unload.

Result

Field	Type	Description
wallet_name	string	The name of the unloaded wallet.

pactus.wallet.get_total_balance

GetTotalBalance returns the total available balance of the wallet.

Parameters

Field	Type	Description
wallet_name	string	The name of the wallet to get the total balance.

Result

Field	Type	Description
wallet_name	string	The name of the wallet.
total_balance	numeric	The total balance of the wallet in NanoPAC.

pactus.wallet.sign_raw_transaction

SignRawTransaction signs a raw transaction for a specified wallet.

Parameters

Field	Type	Description
wallet_name	string	The name of the wallet used for signing.
raw_transaction	string	The raw transaction data to be signed.
password	string	The password for unlocking the wallet for signing.

Result

Field	Type	Description
transaction_id	string	The ID of the signed transaction.
signed_raw_transaction	string	The signed raw transaction data.

pactus.wallet.get_validator_address

GetValidatorAddress retrieves the validator address associated with a public key.

Parameters

Field	Type	Description
public_key	string	The public key for which the validator address is requested.

Result

Field	Type	Description
address	string	The validator address associated with the public key.

pactus.wallet.get_new_address

GetNewAddress generates a new address for the specified wallet.

Parameters

Field	Type	Description
wallet_name	string	The name of the wallet to generate a new address.
address_type	numeric	(Enum)The type of address to generate. Available values: ADDRESS_TYPE_TREASURY = 0 (Treasury address type. Should not be used to generate new addresses.) ADDRESS_TYPE_VALIDATOR = 1 (Validator address type.) ADDRESS_TYPE_BLS_ACCOUNT = 2 (Account address type with BLS signature scheme.) ADDRESS_TYPE_ED25519_ACCOUNT = 3 (Account address type with Ed25519 signature scheme. Note: Generating a new Ed25519 address requires the wallet password.)
label	string	A label for the new address.
password	string	Password for the new address. It's required when address_type is ADDRESS_TYPE_ED25519_ACCOUNT.

Result

Field	Type	Description
wallet_name	string	The name of the wallet from which the address is generated.
address_info	object	Information about the newly generated address.
address_info.address	string	The address string.
address_info.public_key	string	The public key associated with the address.
address_info.label	string	A label associated with the address.
address_info.path	string	The Hierarchical Deterministic path of the address within the wallet.

pactus.wallet.get_address_history

GetAddressHistory retrieves the transaction history of an address.

Parameters

Field	Type	Description
wallet_name	string	The name of the wallet.
address	string	The address to retrieve the transaction history for.

Result

Field	Type	Description
history_info	repeated object	Array of history information for the address.
history_info[].transaction_id	string	The transaction ID hash.
history_info[].time	numeric	The timestamp of the transaction.
history_info[].payload_type	string	The payload type of the transaction.
history_info[].description	string	A description of the transaction.
history_info[].amount	numeric	The amount involved in the transaction.

pactus.wallet.sign_message

SignMessage signs an arbitrary message.

Parameters

Field	Type	Description
wallet_name	string	The name of the wallet.
password	string	The password for unlocking the wallet for signing.
address	string	The account address associated with the private key.
message	string	The arbitrary message to be signed.

Result

Field	Type	Description
signature	string	Signature of the message.

pactus.wallet.get_total_stake

GetTotalStake return total stake of wallet.

Parameters

Field	Type	Description
wallet_name	string	The name of the wallet.

Result

Field	Type	Description
total_stake	numeric
wallet_name	string

pactus.wallet.get_address_info

GetAddressInfo return address information.

Parameters

Field	Type	Description
wallet_name	string	The name of the wallet to generate a new address.
address	string	`</td>`

Result

Field	Type	Description
address	string	`</td>`
label	string	`</td>`
public_key	string	`</td>`
path	string	`</td>`
wallet_name	string	`</td>`

pactus.wallet.set_address_label

SetAddressLabel set label for given address.

Parameters

Field	Type	Description
wallet_name	string	The name of the wallet to generate a new address.
password	string	The password for unlocking the wallet for signing.
address	string	`</td>`
label	string	`</td>`

Result

Field	Type	Description

pactus.wallet.list_wallet

ListWallet return list wallet name.

Parameters

Parameters has no fields.

Result

Field	Type	Description
wallets	repeated string	`</td>`

pactus.wallet.get_wallet_info

GetWalletInfo return wallet information.

Parameters

Field	Type	Description
wallet_name	string	`</td>`

Result

Field	Type	Description
wallet_name	string	`</td>`
version	numeric	`</td>`
network	string	`</td>`
encrypted	boolean	`</td>`
uuid	string	`</td>`
created_at	numeric	`</td>`

pactus.wallet.list_address

ListAddress return list address in wallet.

Parameters

Field	Type	Description
wallet_name	string	`</td>`

Result

Field	Type	Description
data	repeated object	`</td>`
data[].address	string	The address string.
data[].public_key	string	The public key associated with the address.
data[].label	string	A label associated with the address.
data[].path	string	The Hierarchical Deterministic path of the address within the wallet.

Last updated on November 20, 2024

GRPC API Reference HTTP API Reference