Query the current tip of the blockchain including slot, block number, epoch, and sync progress.

Query UTxO entries. Filter by address and/or specific transaction inputs.

Args:

• address (string, optional): Bech32 address to query UTxOs for

• tx_ins (string[], optional): Specific UTxO references in format "tx_hash#index"

At least one of address or tx_ins must be provided.

Returns: UTxO set as formatted text.

Query current protocol parameters. Optionally write to a file for use in transaction fee calculation.

Args:

• out_file (string, optional): File path to write protocol parameters JSON to

Returns: Protocol parameters as JSON.

Query the current stake distribution across all stake pools.

Query information about a stake address including delegation and rewards.

Args:

• address (string): Bech32 stake address to query

Returns: Stake address info including delegation and reward balance.

Query the current governance state including proposals, DReps, and committee info.

Query DRep (Delegated Representative) state. Optionally filter by DRep key hash.

Args:

• drep_key_hash (string, optional): Hex-encoded DRep key hash to filter by

Returns: DRep state information.

Query the current constitutional committee state.

Query the transaction mempool. Supports three subcommands: info (mempool stats), next-tx (next transaction), has-tx (check if a specific tx is in mempool).

Args:

• subcmd (string): One of "info", "next-tx", "has-tx" (default: "info")

• tx_id (string, optional): Transaction ID hash for has-tx subcommand

Returns: Mempool information based on subcommand.

Query all registered stake pool IDs.

Query stake snapshots (mark, set, go). Optionally filter by stake pool ID.

Args:

• stake_pool_id (string, optional): Bech32 or hex stake pool ID

Returns: Stake snapshot data.

Query stake pool parameters. Optionally filter by stake pool ID.

Args:

• stake_pool_id (string, optional): Bech32 or hex stake pool ID

Returns: Pool parameter details.

Query the current treasury and reserves balances.

Query the current on-chain constitution.

Query the current governance ratification state.

Calculate the leadership schedule for a stake pool operator.

Args:

• vrf_signing_key_file (string): Path to VRF signing key file

• epoch_nonce (string): 64-character hex epoch nonce

• epoch_start_slot (number): Slot number at the start of the epoch

• epoch_length (number, optional): Epoch length in slots (default: 432000)

• relative_stake (number): Pool's relative stake as a decimal (e.g., 0.001)

• active_slot_coeff (number, optional): Active slot coefficient (default: 0.05)

Returns: List of slots where the pool is elected to produce blocks.

Generate a payment address key pair (verification key and signing key).

Args:

• verification_key_file (string): Output path for the verification key

• signing_key_file (string): Output path for the signing key

Returns: Confirmation that keys were generated.

Get the hash of a payment verification key.

Args:

• payment_verification_key_file (string): Path to the payment verification key file

Returns: The key hash as hex string.

Build a Cardano address from verification keys.

Args:

• payment_verification_key_file (string): Path to payment verification key file

• stake_verification_key_file (string, optional): Path to stake verification key file (for base addresses)

• out_file (string, optional): File path to write the address to

Returns: The bech32 address.

Decode and display information about a Cardano address.

Args:

• address (string): Bech32-encoded Cardano address

Returns: Address type, network, and credential information.

Generate a payment signing and verification key pair.

Args:

• signing_key_file (string): Output path for the signing key

• verification_key_file (string): Output path for the verification key

Returns: Confirmation that keys were generated.

Generate a stake signing and verification key pair.

Args:

• signing_key_file (string): Output path for the signing key

• verification_key_file (string): Output path for the verification key

Returns: Confirmation that keys were generated.

Get the hash of a verification key.

Args:

• verification_key_file (string): Path to the verification key file

Returns: The key hash as hex string.

Build a transaction body. Supports inputs, outputs, change address, fees, TTL, certificates, withdrawals, metadata, collateral, required signers, and minting.

Args:

• tx_ins (string[]): Transaction inputs in format "tx_hash#index"

• tx_outs (string[]): Transaction outputs in format "address+amount" (amount in lovelace, or "address+amount+multi_asset")

• change_address (string, optional): Address to send change to (required for auto-balancing)

• fee (number, optional): Transaction fee in lovelace (if omitted, auto-calculated when change_address provided)

• ttl (number, optional): Transaction time-to-live (slot number)

• certificate_files (string[], optional): Paths to certificate files to include

• withdrawals (string[], optional): Stake withdrawals in format "stake_address+amount"

• metadata_json_file (string, optional): Path to metadata JSON file

• tx_in_collateral (string[], optional): Collateral inputs in format "tx_hash#index"

• required_signer_hashes (string[], optional): Required signer key hashes

• mint (string[], optional): Minting operations in format "policy_id.asset_name+/-quantity"

• out_file (string): Output path for the transaction body file

Returns: Confirmation with estimated fee (if auto-calculated).

Sign a transaction body with one or more signing keys.

Args:

• tx_body_file (string): Path to the transaction body file

• signing_key_files (string[]): Paths to signing key files

• out_file (string): Output path for the signed transaction

Returns: Confirmation that transaction was signed.

Submit a signed transaction to the blockchain via the node.

Args:

• tx_file (string): Path to the signed transaction file

Returns: Confirmation that the transaction was submitted, or validation error details.

Get the transaction ID (hash) from a transaction file.

Args:

• tx_file (string): Path to the transaction file (signed or unsigned)

Returns: The transaction ID as hex string.

Calculate the minimum fee for a transaction.

Args:

• tx_body_file (string): Path to the transaction body file

• witness_count (number, optional): Number of witnesses (default: 1)

• protocol_params_file (string): Path to protocol parameters JSON file

Returns: The minimum fee in lovelace.

Display the contents of a transaction file in human-readable format.

Args:

• tx_file (string): Path to the transaction file

Returns: Transaction details.

Create a witness for a transaction body using a signing key.

Args:

• tx_body_file (string): Path to the transaction body file

• signing_key_file (string): Path to the signing key file

• out_file (string): Output path for the witness file

Returns: Confirmation that witness was created.

Assemble a transaction from a body and witness files.

Args:

• tx_body_file (string): Path to the transaction body file

• witness_files (string[]): Paths to witness files

• out_file (string): Output path for the assembled signed transaction

Returns: Confirmation that transaction was assembled.

Compute the policy ID from a minting policy script file.

Args:

• script_file (string): Path to the minting policy script file

Returns: The policy ID as hex string.

Generate a stake address key pair.

Args:

• verification_key_file (string): Output path for the verification key

• signing_key_file (string): Output path for the signing key

Build a stake address from a stake verification key.

Args:

• stake_verification_key_file (string): Path to stake verification key file

• out_file (string, optional): File path to write the address to

Returns: The bech32 stake address.

Create a stake address registration certificate.

Args:

• stake_verification_key_file (string): Path to stake verification key file

• key_reg_deposit_amt (number, optional): Key registration deposit amount in lovelace (Conway era)

• out_file (string): Output path for the certificate file

Create a stake address deregistration certificate.

Args:

• stake_verification_key_file (string): Path to stake verification key file

• key_reg_deposit_amt (number, optional): Key registration deposit amount in lovelace (Conway era)

• out_file (string): Output path for the certificate file

Create a stake delegation certificate to delegate to a stake pool.

Args:

• stake_verification_key_file (string): Path to stake verification key file

• stake_pool_id (string): Bech32 or hex stake pool ID to delegate to

• out_file (string): Output path for the certificate file

Create a vote delegation certificate to delegate voting power to a DRep, or to always abstain/no-confidence.

Args:

• stake_verification_key_file (string): Path to stake verification key file

• drep_verification_key_file (string, optional): Path to DRep verification key file

• always_abstain (boolean, optional): Delegate to always-abstain

• always_no_confidence (boolean, optional): Delegate to always-no-confidence

• out_file (string): Output path for the certificate file

Exactly one of drep_verification_key_file, always_abstain, or always_no_confidence must be provided.

Generate stake pool cold key pair and operational certificate counter.

Args:

• cold_verification_key_file (string): Output path for the cold verification key

• cold_signing_key_file (string): Output path for the cold signing key

• operational_certificate_counter_file (string): Output path for the op cert counter

Get the pool ID from a cold verification key.

Args:

• cold_verification_key_file (string): Path to the cold verification key file

Returns: The pool ID as bech32 string.

Generate a VRF (Verifiable Random Function) key pair for a stake pool.

Args:

• verification_key_file (string): Output path for the VRF verification key

• signing_key_file (string): Output path for the VRF signing key

Generate a KES (Key Evolving Signature) key pair for a stake pool.

Args:

• verification_key_file (string): Output path for the KES verification key

• signing_key_file (string): Output path for the KES signing key

Issue an operational certificate for a stake pool.

Args:

• kes_verification_key_file (string): Path to KES verification key file

• cold_signing_key_file (string): Path to cold signing key file

• operational_certificate_counter_file (string): Path to op cert counter file

• kes_period (number): Current KES period

• out_file (string): Output path for the operational certificate

Create a stake pool retirement certificate.

Args:

• cold_verification_key_file (string): Path to cold verification key file

• epoch (number): Epoch in which the pool will be retired

• out_file (string): Output path for the certificate file

Create a stake pool registration certificate with full pool parameters.

Args:

• cold_verification_key_file (string): Path to cold verification key file

• vrf_verification_key_file (string): Path to VRF verification key file

• pledge (number): Pledge amount in lovelace

• cost (number): Fixed cost per epoch in lovelace

• margin (number): Pool margin (0.0 to 1.0)

• reward_account_verification_key_file (string): Path to reward account verification key

• pool_owner_verification_key_files (string[]): Paths to pool owner verification keys

• pool_relay_ipv4 (string[], optional): IPv4 relays in format "IP:port"

• single_host_pool_relay (string[], optional): DNS relays in format "hostname:port"

• multi_host_pool_relay (string[], optional): Multi-host DNS relays

• metadata_url (string, optional): Pool metadata URL

• metadata_hash (string, optional): Pool metadata hash (hex)

• out_file (string): Output path for the certificate file

Generate a DRep (Delegated Representative) key pair.

Args:

• verification_key_file (string): Output path for the verification key

• signing_key_file (string): Output path for the signing key

Get the DRep ID from a verification key file.

Args:

• drep_verification_key_file (string): Path to DRep verification key file

• output_format (string, optional): Output format: "bech32" (default) or "hex"

Returns: The DRep ID.

Create a DRep registration certificate.

Args:

• drep_verification_key_file (string): Path to DRep verification key file

• key_reg_deposit_amt (number): Registration deposit in lovelace

• anchor_url (string, optional): DRep metadata anchor URL

• anchor_data_hash (string, optional): DRep metadata anchor data hash

• out_file (string): Output path for the certificate

Create a DRep retirement certificate.

Args:

• drep_verification_key_file (string): Path to DRep verification key file

• deposit_amt (number): Deposit refund amount in lovelace

• out_file (string): Output path for the certificate

Create a DRep update certificate to update anchor metadata.

Args:

• drep_verification_key_file (string): Path to DRep verification key file

• anchor_url (string, optional): Updated anchor URL

• anchor_data_hash (string, optional): Updated anchor data hash

• out_file (string): Output path for the certificate

Create a governance vote file for a governance action.

Args:

• governance_action_tx_id (string): Transaction ID of the governance action

• governance_action_index (number): Index of the governance action in the transaction

• vote (string): Vote choice: "yes", "no", or "abstain"

• drep_verification_key_file (string, optional): Path to DRep verification key (for DRep voter)

• cold_verification_key_file (string, optional): Path to cold verification key (for SPO voter)

• cc_hot_verification_key_file (string, optional): Path to CC hot verification key (for CC voter)

• anchor_url (string, optional): Vote rationale anchor URL

• anchor_data_hash (string, optional): Vote rationale anchor data hash

• out_file (string): Output path for the vote file

Exactly one voter key file must be provided (DRep, SPO, or CC).

Create an informational governance action (no on-chain effect, used for signaling).

Args:

• anchor_url (string): Anchor URL for the action metadata

• anchor_data_hash (string): Anchor data hash

• deposit (number): Governance action deposit in lovelace

• return_addr (string): Bech32 stake address for deposit return

• out_file (string): Output path for the action file

Create a motion of no confidence in the current constitutional committee.

Args:

• anchor_url (string): Anchor URL

• anchor_data_hash (string): Anchor data hash

• deposit (number): Deposit in lovelace

• return_addr (string): Stake address for deposit return

• prev_governance_action_tx_id (string, optional): Previous governance action tx ID

• prev_governance_action_index (number, optional): Previous governance action index

• out_file (string): Output path

Create a new constitution governance action.

Args:

• anchor_url (string): Anchor URL

• anchor_data_hash (string): Anchor data hash

• deposit (number): Deposit in lovelace

• return_addr (string): Stake address for deposit return

• constitution_url (string): Constitution document URL

• constitution_hash (string): Constitution document hash

• constitution_script_hash (string, optional): Guardian script hash

• prev_governance_action_tx_id (string, optional): Previous action tx ID

• prev_governance_action_index (number, optional): Previous action index

• out_file (string): Output path

Create a hard fork initiation governance action.

Args:

• anchor_url (string): Anchor URL

• anchor_data_hash (string): Anchor data hash

• deposit (number): Deposit in lovelace

• return_addr (string): Stake address for deposit return

• protocol_major_version (number): Target major protocol version

• protocol_minor_version (number): Target minor protocol version

• prev_governance_action_tx_id (string, optional): Previous action tx ID

• prev_governance_action_index (number, optional): Previous action index

• out_file (string): Output path

Compute the hash of anchor data from a file.

Args:

• file_binary (string, optional): Path to binary file to hash

• file_text (string, optional): Path to text file to hash

Exactly one of file_binary or file_text must be provided.

Returns: The blake2b-256 hash of the file contents.

Create a governance action to update protocol parameters.

Args:

• anchor_url (string): Anchor URL

• anchor_data_hash (string): Anchor data hash

• deposit (number): Deposit in lovelace

• return_addr (string): Stake address for deposit return

• protocol_parameters_update (string): Path to JSON file with parameter updates

• constitution_script_hash (string, optional): Guardian script hash

• prev_governance_action_tx_id (string, optional): Previous action tx ID

• prev_governance_action_index (number, optional): Previous action index

• out_file (string): Output path

Create a governance action to update the constitutional committee.

Args:

• anchor_url (string): Anchor URL

• anchor_data_hash (string): Anchor data hash

• deposit (number): Deposit in lovelace

• return_addr (string): Stake address for deposit return

• threshold (string): Quorum threshold as "numerator/denominator"

• remove_cc_cold_verification_key_hashes (string[], optional): CC member key hashes to remove

• add_cc_cold_verification_key_hashes (string[], optional): CC members to add as "key_hash,expiry_epoch"

• prev_governance_action_tx_id (string, optional): Previous action tx ID

• prev_governance_action_index (number, optional): Previous action index

• out_file (string): Output path

Create a governance action to withdraw funds from the treasury.

Args:

• anchor_url (string): Anchor URL

• anchor_data_hash (string): Anchor data hash

• deposit (number): Deposit in lovelace

• return_addr (string): Stake address for deposit return

• funds_receiving_stake_verification_key_file (string): Path to stake verification key of funds recipient

• transfer (number): Amount to withdraw in lovelace

• out_file (string): Output path

Generate node cold key pair and operational certificate counter.

Args:

• cold_verification_key_file (string): Output path for the cold verification key

• cold_signing_key_file (string): Output path for the cold signing key

• operational_certificate_counter_file (string): Output path for the op cert counter

Generate KES (Key Evolving Signature) key pair for a block-producing node.

Args:

• verification_key_file (string): Output path for the KES verification key

• signing_key_file (string): Output path for the KES signing key

Generate VRF (Verifiable Random Function) key pair for a block-producing node.

Args:

• verification_key_file (string): Output path for the VRF verification key

• signing_key_file (string): Output path for the VRF signing key

Issue an operational certificate for a block-producing node.

Args:

• kes_verification_key_file (string): Path to KES verification key file

• cold_signing_key_file (string): Path to cold signing key file

• operational_certificate_counter_file (string): Path to op cert counter file

• kes_period (number): Current KES period

• out_file (string): Output path for the operational certificate

Create a new operational certificate counter with a specified value.

Args:

• cold_verification_key_file (string): Path to cold verification key file

• counter_value (number): Counter value to set

• operational_certificate_counter_file (string): Output path for the counter file