SDKSDK

import { XerisClient, XerisKeypair } from 'xeris-sdk'; const client = XerisClient.testnet(); // from keypair_gen, wallet keygen or saveToFile const wallet = XerisKeypair.fromJsonFile('./keypair.json'); const { signature } = await client.transferXrs(wallet, '<recipient>', 1); const tx = await client.waitForConfirmation(signature); console.log(tx.status); // "confirmed"

const kp = XerisKeypair.generate(); kp.saveToFile('keypair.json'); // JSON array of 64 bytes, mode 0600 console.log(kp.publicKey); // base58 kp.sign(message); // Ed25519, 64 bytes // the file xrs-node --validator and the wallet CLI read const same = XerisKeypair.fromJsonFile('keypair.json');

import { toBaseUnits } from 'xeris-sdk'; // signer = mint authority; maxSupply in base units await client.createToken(wallet, 'mytoken', 'My Token', 'MTK', 9, toBaseUnits('1000000', 9)); // 1,000 MTK await client.mintTokens(wallet, 'mytoken', to, toBaseUnits('1000', 9)); await client.transferToken(wallet, 'mytoken', to, toBaseUnits('50', 9)); // { native_xrs, token_accounts: [{ token_id, balance, … }] } await client.getTokenAccounts(to);

// the DEX and the launchpad spend wrapped XRS await client.wrapXrs(wallet, 10); // POST /agent/plan: amount_in in lamports, slippage 1 % const swap = await client.planSwap(poolId, 'xrs_native', 1_000_000_000, 1); // args: 16 raw bytes, amount_in ‖ min_output, u64 LE (encodeSwapCall) await client.swap(wallet, poolId, swap.params.method, 1_000_000_000, swap.quote.min_amount_out); const buy = await client.planBuyLaunchpad(launchpadId, 1_000_000_000, 1); // args: JSON { xrs_amount, min_tokens_out } await client.buyOnLaunchpad(wallet, launchpadId, 1_000_000_000, buy.quote.min_tokens_out); // any plan: await client.sendInstruction(wallet, fromPlan(plan))

import { XerisDApp } from 'xeris-sdk'; // { host } for another node; mainnet needs one const dapp = new XerisDApp(); await dapp.connect(); // window.xeris signs; the SDK holds no key await dapp.getBalance(); // the connected address const { signature } = await dapp.transferXrs(to, 5); await dapp.waitForConfirmation(signature);

await client.registerAgent( owner, 'ari-trader', agentKp.publicKey, 5_000_000_000, // max_per_tx, lamports 10_000_000_000, // max_daily, lamports, per 21,600 slots [], // allowed_contracts, empty = any // allowed_operations, exact strings from AGENT_OPERATIONS ['NativeTransfer', 'WrapXrs', 'UnwrapXrs'], 0, // expires_at_slot, 0 = never );

import { XerisAgent } from 'xeris-sdk'; const agent = XerisAgent.testnet(agentKp, owner.publicKey); await agent.getPermissions(); // { authorized, revoked, expired, agent } // once, before the first heartbeat await agent.createIdentity('Ari Trader', '{}'); // model hash, active tasks, capacity, status await agent.heartbeat('', 1, 9, 'online'); const [task] = await agent.findTasks({ category: 'trading' }); await agent.claimTask(task.task_id); // AgentExecute: runs as the owner, inside the limits await agent.transferXrs(to, 2); // swaps, launchpad buys and Stake cannot be delegated await agent.completeTask(task.task_id, proof);

import { buildPqRotationMessage, CHAIN_ID_TESTNET } from 'xeris-sdk'; // ML-DSA-65 public key, 1,952 bytes; POST /pq-register await client.pqKeyRegister(wallet, pqPublicKey, 'dilithium3', 3); // { has_pq_key, algorithm, security_level, rotation_count, … } const key = await client.getPqKey(wallet.publicKey); await client.getPqStatus(); const msg = buildPqRotationMessage( CHAIN_ID_TESTNET, pqPublicKey, newPqPublicKey, key.rotation_count); // proof: the current key signs msg, ML-DSA-65, 3,309 bytes await client.pqKeyRotate(wallet, newPqPublicKey, 'dilithium3', proof);