API Documentation

Functions available for registered users and delegated canisters

Canister ID: 7jsss-6qaaa-aaaad-aegpq-cai

Network: Internet Computer Mainnet

Bug Reports: Discord

Timestamps: All timestamp fields (created_at, expires_at, last_used, etc.) are in nanoseconds since Unix epoch (1970-01-01 00:00:00 UTC).

Nano Amounts: Returned as text strings because they exceed nat64 max value. Format: raw units (1 NANO = 10³⁰ raw).

Node Parameter: Accepts public node alias (e.g. nanogate1). Use null for automatic node selection.

Version 1.4.1 — February 21, 2026

Public No authentication

Standard User or delegated canister

User Caller's own account and resources only

Quick Start

All functions are called via dfx canister call. Here are some examples:

Check your credits:

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai get_my_user_credits --network ic

Get Nano account balance:

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai get_account_balance \
  '("nano_1gatexyacr8fa7gerjz78yunsjzuid9p8a566k4prxcu68fcw3h9oi7619zu", null)' \
  --network ic

Generic RPC call (any Nano action):

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai send_simple_nano_request \
  '(record { action = "block_count"; node = null })' \
  --network ic

For all Nano RPC actions and their parameters, see the Nano RPC Protocol Documentation.

For type definitions, see also the Candid UI. Note: The Candid UI appears cluttered because all error variants are fully expanded inline and cannot be collapsed. Every function shows the complete NanoError type with all 15 error categories, making signatures harder to read.

Nano RPC ↑

Core blockchain queries. All functions require credits unless marked free. Base cost: 10 credits, rising with data volume in bulk calls (max 50 items per request).

Note: The generic send_simple_nano_request returns a NanoResponse with raw JSON data that you need to parse yourself. For common operations, prefer the typed wrapper functions below (e.g., get_account_balance, get_version) which return structured responses.

Generic RPC endpoint - supports all Nano RPC actions Standard10+ creditsUpdate

send_simple_nano_request(request: SimpleNanoRequest) → NanoResponse

request: Record with action (text), account?, accounts?, hash?, hashes?, count?, threshold?, head?, key?, root?, work?, difficulty?, subtype?, block?, node?, raw?, source?, json_block?, weight?, representative?, receivable?, include_confirmed?, force?, async_process?, sorting?, offset?, account_filter?, reverse?, receive_hash?, pending?, include_not_found?, include_active?, include_linked_account?, multiplier?, announcements?, contents?, peer_details? (reserved), modified_since? (reserved), link? (reserved), destination? (reserved), version? (reserved), include_cemented? (reserved), start? (reserved), representatives? (reserved)

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai send_simple_nano_request '(record { action = "block_count"; node = null })' --network ic
Get balance for a Nano address (in raw) Standard10 creditsUpdate

get_account_balance(address, node?) → BalanceResponse

address: Nano address · node: Node alias (null = auto-select) · Returns: { balance, pending?, node_used?, response_time_ms? }

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai get_account_balance '("nano_3rrfgsjs653mefzpf81sqcty13cg5aseoccem5sajwjb1crqkxmdksdkhe14", null)' --network ic
Get transaction history with pagination support Standard11+ creditsUpdate

get_account_history(GetAccountHistoryRequest) → AccountHistoryResponse

account: Nano address · count: Number of transactions · head_hash?: Start hash for pagination · offset?: Skip N entries · reverse?: Oldest first (default: newest first) · node?: Node alias · Returns: { transactions, next_head_hash? }

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai get_account_history '(record { account = "nano_3rrfgsjs653mefzpf81sqcty13cg5aseoccem5sajwjb1crqkxmdksdkhe14"; count = 10 : nat32; head_hash = null; offset = null; reverse = null; node = null })' --network ic
Get balances for multiple addresses in one call Standard11+ creditsUpdate

get_multiple_balances(addresses, node?) → MultipleBalancesResponse

addresses: Vector of Nano addresses (min 1) · node: Node alias · Returns: vec of { account, balance }, node_used?, response_time_ms?

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai get_multiple_balances '(vec { "nano_3rrfgsjs653mefzpf81sqcty13cg5aseoccem5sajwjb1crqkxmdksdkhe14"; "nano_1gatexyacr8fa7gerjz78yunsjzuid9p8a566k4prxcu68fcw3h9oi7619zu" }, null)' --network ic
Get number of blocks for an account Standard10 creditsUpdate

get_account_block_count(address, node?) → nat64

address: Nano address · node: Node alias

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai get_account_block_count '("nano_3rrfgsjs653mefzpf81sqcty13cg5aseoccem5sajwjb1crqkxmdksdkhe14", null)' --network ic
Get the representative for an account Standard10 creditsUpdate

get_account_representative(address, node?) → text

address: Nano address · node: Node alias

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai get_account_representative '("nano_1gatexyacr8fa7gerjz78yunsjzuid9p8a566k4prxcu68fcw3h9oi7619zu", null)' --network ic
Get voting weight for an account Standard10 creditsUpdate

get_account_weight(address, node?) → text

address: Nano address · node: Node alias

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai get_account_weight '("nano_1forge6zb5tjtduqo8mr4xromissc5q8mku4m1yn71mf1apuxnhc7fszq7jm", null)' --network ic
Get frontier hashes for multiple accounts Standard11+ creditsUpdate

get_accounts_frontiers(addresses, node?) → AccountsFrontiersResponse

addresses: Vector of Nano addresses (min 1) · node: Node alias · Returns: vec of { account, frontier }, node_used?, response_time_ms?

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai get_accounts_frontiers '(vec { "nano_3rrfgsjs653mefzpf81sqcty13cg5aseoccem5sajwjb1crqkxmdksdkhe14"; "nano_1gatexyacr8fa7gerjz78yunsjzuid9p8a566k4prxcu68fcw3h9oi7619zu" }, null)' --network ic
Get pending/receivable blocks for an account Standard11+ creditsUpdate

get_receivable(GetReceivableRequest) → ReceivableResponse

account: Nano address · count: Max blocks (max 50) · threshold?: Min amount · source?: Include sender · node?: Node alias · Returns: vec of { hash, amount, source? }, node_used?, response_time_ms?

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai get_receivable '(record { account = "nano_3rrfgsjs653mefzpf81sqcty13cg5aseoccem5sajwjb1crqkxmdksdkhe14"; count = 10 : nat32; threshold = null; source = null; node = null })' --network ic
Get network stats (block count, cemented, unchecked) Standard10 creditsUpdate

get_network_status(node?) → NetworkStatus

node: Node alias (null = auto-select) · Returns: total_blocks, cemented_blocks, unchecked_blocks

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai get_network_status '(opt "nanogate1")' --network ic
Get Nano node version info Standard10 creditsUpdate

get_version(node?) → VersionInfo

node: Node alias (null = auto-select) · Returns: rpc_version, store_version, protocol_version, node_vendor, network, node_used?, response_time_ms?

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai get_version '(opt "nanogate1")' --network ic
Get list of online representatives Standard12 creditsUpdate

get_representatives_online(GetRepresentativesOnlineRequest) → RepresentativesOnlineResponse

weight?: Include weight (true/false) · accounts?: Filter by accounts · node?: Node alias · Returns: vec of { account, weight? }, node_used?, response_time_ms?

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai get_representatives_online '(record { weight = null; accounts = null; node = null })' --network ic
Check if a block hash is receivable Standard10 creditsUpdate

is_block_receivable(hash, node?) → BlockReceivableResponse

hash: Block hash (64 hex chars) · node: Node alias · Returns: { exists: bool, node_used?, response_time_ms? }

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai is_block_receivable '("1A04FF7D3D343AED26132186941653900C2FC963F673B6493947E1566B74805A", null)' --network ic
Get public key for a Nano address Standard10 creditsUpdate

get_account_key(address, node?) → text

address: Nano address · node: Node alias (null = auto-select)

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai get_account_key '("nano_1gatexyacr8fa7gerjz78yunsjzuid9p8a566k4prxcu68fcw3h9oi7619zu", null)' --network ic
Get Nano address from public key Standard10 creditsUpdate

get_account_from_public_key(key, node?) → text

key: Public key (64 hex chars) · node: Node alias (null = auto-select)

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai get_account_from_public_key '("391A677C8560CD415CCC47E537B74CC7FB82CF63206424856C755B219AAE05E7", null)' --network ic
Get account that owns a block Standard10 creditsUpdate

get_block_account(hash, node?) → text

hash: Block hash (64 hex chars) · node: Node alias (null = auto-select) · Returns: Nano account address

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai get_block_account '("1A04FF7D3D343AED26132186941653900C2FC963F673B6493947E1566B74805A", null)' --network ic

Transactions ↑

Send and receive Nano. Sign transactions yourself and broadcast via the gateway.

Get balance, frontier, representative for building transactions Standard10 creditsUpdate

get_account_info_for_signing(address, node?) → AccountInfoForSigning

address: Nano address · node: Node alias (null = auto-select) · Returns: { account, balance, frontier, representative, block_count, is_new_account, node_used?, response_time_ms? }

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai get_account_info_for_signing '("nano_1gatexyacr8fa7gerjz78yunsjzuid9p8a566k4prxcu68fcw3h9oi7619zu", null)' --network ic
Broadcast a pre-signed block to the network Standard10 creditsUpdate

broadcast_signed_block(SignedBlock) → TransactionResult

SignedBlock: record { block_type, account, previous, representative, balance, link, signature, work, subtype?, node? } · Returns: { success, hash?, error?, node_used?, response_time_ms? }

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai broadcast_signed_block '(record { block_type = "state"; account = "nano_3rrfgsjs653mefzpf81sqcty13cg5aseoccem5sajwjb1crqkxmdksdkhe14"; previous = "C9973DD7A2FAE86512A4216D2ED36954D83DF9B2B786C846CDD0E2ED3D12CF66"; representative = "nano_1tk8h3yzkibbsti8upkfa69wqafz6mzfzgu8bu5edaay9k7hidqdunpr4tb6"; balance = "761594180000000000000000000000"; link = "959A79DCE2C123F30C3B3BC74F4CE8E79B15F9DE599142441F7ACD3A68B69DD1"; signature = "F10AA0089D8BBF9DCE36A64D7A5A949A4851BF0F020ED152EAE61EE8601C8284DC93E42E7C7402FAFF653A20C8B4D0539678827E9232C2EC8F1820BF9708F70E"; work = "39382d98b6430305"; subtype = opt "send"; node = null })' --network ic
Generate proof of work via gateway PoW servers Standard12 creditsUpdate

generate_pow(GeneratePowRequest) → PowResult

hash: Block hash or frontier · difficulty: PoW difficulty · preferred_server?: PoW server alias (null = auto) · Returns: { work, server_used }

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai generate_pow '(record { hash = "75DE72F147FE280F0A58962FC68BEEA42DB4D551466D32D75B1667068D107DAB"; difficulty = "fffffff800000000"; preferred_server = null })' --network ic

Proof of Work ↑

PoW helpers: get difficulties, validate work locally, or configure your private PoW source.

Get current PoW difficulty for send blocks PublicFreeQuery

get_pow_difficulty_send() → text

(no parameters)

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai get_pow_difficulty_send --network ic
Get current PoW difficulty for receive blocks PublicFreeQuery

get_pow_difficulty_receive() → text

(no parameters)

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai get_pow_difficulty_receive --network ic
Validate proof of work Standard1 creditUpdate

validate_work(ValidateWorkRequest) → WorkValidationResult

hash: Block hash (64 hex) · work: Work value (16 hex) · difficulty?: Optional threshold (default: send difficulty) · Returns: { valid, difficulty }

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai validate_work '(record { hash = "D97147F5ADD2D63260F1A85D4913131872AAC595CBF0CA0884439AB74DBD7B35"; work = "ca1caf7d61a68c90"; difficulty = null })' --network ic
Force PoW generation on your private node User1 creditUpdate

set_force_pow(enabled) → text

enabled: true to enable, false to disable

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai set_force_pow '(true)' --network ic
Get public PoW server info (alias, status, stats) StandardFreeQuery

get_available_pow_servers() → vec AvailablePowServer

(no parameters) · Returns: vec of { alias, active, success_count, average_response_time }

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai get_available_pow_servers --network ic

Nodes ↑

View available nodes and register your private node.

List nodes by tier (primary, backup, offline, untested) StandardFreeQuery

get_available_nodes() → AvailableNodes

(no parameters)

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai get_available_nodes --network ic
Register your own Nano node User1 creditUpdate

register_private_node(url, api_key?, auth_header_name?, auth_header_prefix?) → text

url: Node URL (https) · api_key: Optional API key · auth_header_name: Custom header name (default: "X-API-Key") · auth_header_prefix: Custom value prefix (e.g. "Bearer ")

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai register_private_node '("https://mynode.example.com/api", opt "my-api-key", null, null)' --network ic
Force all your requests to use your private node User1 creditUpdate

set_force_node(enabled) → text

enabled: true to enable, false to disable

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai set_force_node '(true)' --network ic
Get your private node configuration UserFreeQuery

get_my_private_node() → opt PrivateNodeInfo

(no parameters) · Returns: { url, has_api_key, force_enabled, force_pow_enabled, allow_owner_commands, auth_header_name?, auth_header_prefix? }

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai get_my_private_node --network ic
Remove your private node registration User1 creditUpdate

remove_private_node() → text

(no parameters)

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai remove_private_node --network ic
Allow owner-only RPC commands on your private node (requires force_node enabled) User1 creditUpdate

set_allow_owner_commands(enabled) → text

enabled: true to enable, false to disable · Requires: Private node registered and force_node enabled

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai set_allow_owner_commands '(true)' --network ic

Utilities ↑

Helper functions for address validation and unit conversion. Most are free query calls.

Get canister software version PublicFreeQuery

get_canister_version() → text

(no parameters) · Returns: Semantic version string (e.g. "1.4.2")

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai get_canister_version --network ic
Check if a Nano address is valid StandardFreeQuery

validate_nano_address(address) → Ok/Err

address: Nano address to validate

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai validate_nano_address '("nano_1gatexyacr8fa7gerjz78yunsjzuid9p8a566k4prxcu68fcw3h9oi7619zu")' --network ic
Convert raw amount to NANO (30 decimal places) StandardFreeQuery

convert_raw_to_nano(raw) → text

raw: Amount in raw units (text)

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai convert_raw_to_nano '("1000000000000000000000000000000")' --network ic
Convert NANO amount to raw StandardFreeQuery

convert_nano_to_raw(nano) → text

nano: Amount in NANO (text, e.g. "1.5")

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai convert_nano_to_raw '("1.0")' --network ic
Compute hash for a block (for signing) Standard1 creditUpdate

compute_block_hash(block_json) → text

block_json: JSON string of the block (type, account, previous, representative, balance, link)

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai compute_block_hash '("{\"type\":\"state\",\"account\":\"nano_3rrfgsjs653mefzpf81sqcty13cg5aseoccem5sajwjb1crqkxmdksdkhe14\",\"previous\":\"1A04FF7D3D343AED26132186941653900C2FC963F673B6493947E1566B74805A\",\"representative\":\"nano_1tk8h3yzkibbsti8upkfa69wqafz6mzfzgu8bu5edaay9k7hidqdunpr4tb6\",\"balance\":\"861594180000000000000000000000\",\"link\":\"181D48A06246B880A93210D9504BE0B7AB050C06405379DCB911C6F5B759138F\"}")' --network ic

Pricing ↑

Query credit costs and crypto prices.

Note: Credits are charged per node outcall, regardless of the result. If the node returns an error (e.g. "Block not found"), credits are still deducted because the HTTP outcall was made. Validation errors (e.g. invalid address, missing parameter) are caught before the outcall and cost nothing.

Get credit costs for all API actions StandardFreeQuery

get_all_action_prices() → vec ActionPrice

(no parameters) · Returns: vec of { action, credits_cost, description, last_updated, is_active }

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai get_all_action_prices --network ic
Get credit cost for a specific action StandardFreeQuery

get_action_price(action) → ActionPrice

action: Internal action name, not the canister method name (use get_all_action_prices to list valid names)

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai get_action_price '("account_balance")' --network ic
Get current crypto prices (nano, icp, btc, all) Standard5 creditsUpdate

get_crypto_price(currency) → vec PriceData

currency: "nano", "icp", "btc", or "all" · Returns: vec of { currency, usd, eur, source, timestamp }

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai get_crypto_price '("all")' --network ic

User Account ↑

Manage your credits and view transaction history.

Get your full account info (credits, stats, dates) UserFreeQuery

get_my_account_info() → UserAccount

(no parameters) · Returns: { user_principal, credits_balance, total_credits_purchased, total_credits_spent, total_transactions, created_at, last_used, is_active }

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai get_my_account_info --network ic
Get your current credit balance UserFreeQuery

get_my_user_credits() → nat64

(no parameters)

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai get_my_user_credits --network ic
Get your API call history with credit charges (paginated) UserFreeQuery

get_my_transactions(offset, limit) → vec TransactionRecord

offset: nat64 (skip first N) · limit: nat64 (max 500) · Returns: vec of { transaction_id, action, timestamp, success, credits_charged, credits_balance_before, credits_balance_after, error_message?, caller_principal, node_used?, response_time_ms? }

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai get_my_transactions '(0, 50)' --network ic
Transfer credits to another user (4 credit fee deducted from amount) User4 credits feeUpdate

transfer_credits_to_user(TransferCreditsRequest) → text

to_user: Principal of recipient · amount: Credits to transfer (min 100, max 1,000,000) · note: Optional message · Fee: 4 credits deducted from amount (recipient receives amount − 4)

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai transfer_credits_to_user '(record { to_user = principal "aaaaa-aa"; amount = 100 : nat64; note = opt "Thanks!" })' --network ic
Get history of credit transfers (sent and received) UserFreeQuery

get_my_credit_transfer_history() → vec CreditTransferView

(no parameters) · Returns: vec of { transfer_id, direction, counterparty, counterparty_short, amount_sent, amount_received, fee, note?, timestamp }

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai get_my_credit_transfer_history --network ic
Get total number of API calls made UserFreeQuery

get_my_transaction_count() → nat64

(no parameters)

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai get_my_transaction_count --network ic
Get your credit purchase history (ICP payments) UserFreeQuery

get_my_purchases() → vec CreditPurchase

(no parameters) · Returns: vec of { purchase_id, buyer_principal, added_by, credits_purchased, payment_method, payment_amount, exchange_rate, notes?, timestamp, confirmed }

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai get_my_purchases --network ic

Canister Delegation ↑

Delegate your credits to other canisters you control.

List all canisters delegated to your account UserFreeQuery

get_my_canisters() → vec DelegatedCanister

(no parameters) · Returns: vec of { canister_id, owner_principal, is_active, credits_limit?, daily_limit?, expires_at?, credits_used_total, credits_used_today, last_daily_reset, created_at, last_used }

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai get_my_canisters --network ic
Delegate a canister to use your credits User8 creditsUpdate

add_canister_to_my_account(CanisterLimitsRequest) → text

canister_id: Principal · credits_limit?: Total credit limit (null = unlimited) · daily_limit?: Daily limit (null = unlimited) · expires_at?: Expiry timestamp in ns (null = never)

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai add_canister_to_my_account '(record { canister_id = principal "aaaaa-aa"; credits_limit = opt 1000; daily_limit = opt 100; expires_at = null })' --network ic
Remove a delegated canister User1 creditUpdate

remove_canister_from_my_account(canister) → text

canister: Principal of the canister to remove

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai remove_canister_from_my_account '(principal "aaaaa-aa")' --network ic
Update spending limits for a delegated canister User1 creditUpdate

update_canister_limits(CanisterLimitsRequest) → text

canister_id: Principal · credits_limit?: New total limit (null = unlimited) · daily_limit?: New daily limit (null = unlimited) · expires_at?: New expiry in ns (null = never)

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai update_canister_limits '(record { canister_id = principal "aaaaa-aa"; credits_limit = opt 2000; daily_limit = null; expires_at = null })' --network ic
Enable or disable a delegated canister User1 creditUpdate

set_canister_active(canister, active) → text

canister: Principal · active: true to enable, false to disable

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai set_canister_active '(principal "aaaaa-aa", false)' --network ic
Transfer canister delegation to another user User1 creditUpdate

transfer_canister_to_user(canister, new_owner) → text

canister: Principal · new_owner: Principal of new owner

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai transfer_canister_to_user '(principal "aaaaa-aa", principal "bbbbb-bb")' --network ic

Donations ↑

Donate Nano to support the project and receive bonus credits. Credit purchases will be available after beta.

Get current PoW difficulty for order creation PublicFreeQuery

get_pow_challenge_info() → text

(no parameters) · Returns: Difficulty info string

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai get_pow_challenge_info --network ic
Get a PoW challenge (required before creating orders) PublicFreeUpdate

request_pow_challenge() → PowChallenge

(no parameters) · Returns: { challenge_id, hash, difficulty, expires_at, requester, info }

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai request_pow_challenge --network ic
Create a donation with optional credit reward UserFreeUpdate

create_donation_with_pow(CreateDonationWithPowRequest) → DonationOrder

want_credits: true for bonus credits · challenge_id: From request_pow_challenge · work: Solved PoW · Returns: { order_id, status, user_principal, deposit_address, payment_uri, want_credits, nano_amount_raw?, nano_amount_display?, credits_amount?, created_at, expires_at, confirmed_at?, tx_hash?, abuse_warning?, info }

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai create_donation_with_pow '(record { want_credits = true; challenge_id = "challenge-id"; work = "solved-work" })' --network ic
Check donation status (auto-verified every 10s by timer) UserFreeQuery

verify_my_donation(order_id) → DonationResult

order_id: Your donation ID · Returns: { order_id, status, message, tx_hash?, nano_received?, credits_awarded? }

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai verify_my_donation '("donation-123")' --network ic
List your donations UserFreeQuery

get_my_donations() → vec DonationOrder

(no parameters) · Returns: vec of { order_id, status, user_principal, deposit_address, payment_uri, want_credits, nano_amount_raw?, nano_amount_display?, credits_amount?, created_at, expires_at, confirmed_at?, tx_hash?, abuse_warning?, info }

dfx canister call 7jsss-6qaaa-aaaad-aegpq-cai get_my_donations --network ic

← Back to Home