Send a payment

Pay ARRK (or any issued asset) from a key you control to an address.

You need: a regtest node with a funded key (Quick start) and the SDK (TypeScript or Python).

What the example does

Creates a client for the node and reads the network from GET /v1/chain.
Derives a wallet from a seed (hardened ML-DSA-65 keys at m/9000'/0'/0'/change'/index').
On regtest with an admin token, mines 101 blocks to fund itself (coinbase outputs mature after 100 blocks).
Collects mature, unspent coins of the wallet's addresses.
Builds the transaction (deterministic coin selection, change to the wallet's change address) at the node's fee estimate. Amounts are integers in base units (parseArrk("1.5") → 150000000n).
Signs every input. The signature hash commits to the network, the transaction and the asset, amount and lock of every spent output.
Broadcasts it (POST /v1/txs) and prints the txid and fee.

The TypeScript version spells out each step (getCoins, buildTransaction, signTransaction, sendTransaction); the Python version uses the client.send_payment(...) helper, which does the same.

TypeScript · send-payment.ts

/**
 * Send a payment: derive a wallet, fund it on regtest, pay 1.5 ARRK, confirm.
 *
 *   ARREKTA_URL=http://127.0.0.1:28332 ARREKTA_ADMIN_TOKEN=... npx tsx examples/send-payment.ts
 */
import { createClient, formatArrk, fromHex, generateSeed, getAddress, getChain, getCoins, keychainFromSeed, mine, sendPayment } from 'arrekta-sdk';
 
const URL = process.env.ARREKTA_URL ?? 'http://127.0.0.1:28332';
const ADMIN = process.env.ARREKTA_ADMIN_TOKEN; // regtest mining for the demo
const SEED = fromHex(process.env.ARREKTA_SEED ?? 'a1'.repeat(32));
 
// 1. Connect and read the chain.
const client = createClient({ url: URL, adminToken: ADMIN });
const chain = await getChain(client);
console.log(`connected to ${chain.network} at height ${chain.height}`);
 
// 2. Alice's wallet from her seed; Bob gets a fresh one.
const alice = keychainFromSeed(SEED, { network: chain.network });
const bob = keychainFromSeed(generateSeed(), { network: chain.network });
 
// 3. Fund Alice (regtest: mine past coinbase maturity).
if ((await getCoins(client, { wallet: alice })).length === 0) await mine(client, alice.address(0), 101);
 
// 4. Pay Bob 1.5 ARRK (fee rate from the node's estimate).
const sent = await sendPayment(client, { wallet: alice, to: bob.address(0), amount: '1.5' });
console.log(`sent ${sent.txid} (fee ${formatArrk(sent.fee)} ARRK)`);
 
// 5. Confirm and check Bob's balance.
await mine(client, alice.address(0), 1);
const balance = (await getAddress(client, { address: bob.address(0) })).balances[0]!;
console.log(`bob has ${formatArrk(balance.spendable)} ARRK`);

"""Send a payment: derive a wallet, fund it on regtest, pay 1.5 ARRK, confirm.
 
    ARREKTA_URL=http://127.0.0.1:28332 ARREKTA_ADMIN_TOKEN=... python examples/send_payment.py
"""
 
import os
 
from arrekta_sdk import Client, format_arrk, generate_seed, keychain_from_seed
 
URL = os.environ.get("ARREKTA_URL", "http://127.0.0.1:28332")
ADMIN = os.environ.get("ARREKTA_ADMIN_TOKEN")  # regtest mining for the demo
SEED = bytes.fromhex(os.environ.get("ARREKTA_SEED", "a1" * 32))
 
 
def main() -> None:
    # 1. Connect and read the chain.
    client = Client(URL, admin_token=ADMIN)
    chain = client.get_chain()
    print(f"connected to {chain['network']} at height {chain['height']}")
 
    # 2. Alice's wallet from her seed; Bob gets a fresh one.
    alice = keychain_from_seed(SEED, network=chain["network"])
    bob = keychain_from_seed(generate_seed(), network=chain["network"])
 
    # 3. Fund Alice (regtest: mine past coinbase maturity).
    if not client.get_coins(alice):
        client.mine(alice.address(0), 101)
 
    # 4. Pay Bob 1.5 ARRK (fee rate from the node's estimate).
    sent = client.send_payment(alice, bob.address(0), "1.5")
    print(f"sent {sent.txid} (fee {format_arrk(sent.fee)} ARRK)")
 
    # 5. Confirm and check Bob's balance.
    client.mine(alice.address(0), 1)
    balance = client.get_address(bob.address(0))["balances"][0]
    print(f"bob has {format_arrk(balance['spendable'])} ARRK")
 
 
if __name__ == "__main__":
    main()

Source: sdk/typescript/examples/send-payment.ts (updated 2026-11-02) · sdk/python/examples/send_payment.py (updated 2026-11-02). Runnable against a regtest node; CI runs every example.

If something goes wrong

Error code	Meaning
`missing-inputs`	a coin is already spent, or not yet known to the node
`insufficient-fee`	a conflicting transaction pays more; bump the fee
`asset-frozen`	the issuer froze this asset for the sending lock
`tx-expired`	`validUntil` is below the next block height

A payment stuck at a low fee can be replaced (bumpFee) or pulled in by a child (cpfp); see Fees.

Transactions API, Addresses API
Concepts: UTXO & native assets

Send a payment

What the example does

If something goes wrong

Related