SDKSDK

import { XerisClient, XerisKeypair } from 'xeris-sdk'; const client = XerisClient.testnet(); // de keypair_gen, wallet keygen o 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'); // array JSON de 64 bytes, modo 0600 console.log(kp.publicKey); // base58 kp.sign(message); // Ed25519, 64 bytes // el archivo que leen xrs-node --validator y la CLI wallet const same = XerisKeypair.fromJsonFile('keypair.json');

import { toBaseUnits } from 'xeris-sdk'; // el firmante es la autoridad de emisión; maxSupply en unidades base 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);

// el DEX y el launchpad gastan XRS envuelto await client.wrapXrs(wallet, 10); // POST /agent/plan: amount_in en lamports, slippage 1 % const swap = await client.planSwap(poolId, 'xrs_native', 1_000_000_000, 1); // args: 16 bytes crudos, 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); // cualquier plan: await client.sendInstruction(wallet, fromPlan(plan))

import { XerisDApp } from 'xeris-sdk'; // { host } para otro nodo; mainnet lo exige const dapp = new XerisDApp(); await dapp.connect(); // window.xeris firma; el SDK no guarda ninguna clave await dapp.getBalance(); // la dirección conectada 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, por 21,600 slots [], // allowed_contracts, vacío = cualquiera // allowed_operations, cadenas exactas de AGENT_OPERATIONS ['NativeTransfer', 'WrapXrs', 'UnwrapXrs'], 0, // expires_at_slot, 0 = nunca );

import { XerisAgent } from 'xeris-sdk'; const agent = XerisAgent.testnet(agentKp, owner.publicKey); await agent.getPermissions(); // { authorized, revoked, expired, agent } // una vez, antes del primer heartbeat await agent.createIdentity('Ari Trader', '{}'); // hash del modelo, tareas activas, capacidad, estado await agent.heartbeat('', 1, 9, 'online'); const [task] = await agent.findTasks({ category: 'trading' }); await agent.claimTask(task.task_id); // AgentExecute: se ejecuta como el dueño, dentro de los límites await agent.transferXrs(to, 2); // swaps, compras en launchpad y Stake no se delegan await agent.completeTask(task.task_id, proof);

import { buildPqRotationMessage, CHAIN_ID_TESTNET } from 'xeris-sdk'; // clave pública ML-DSA-65, 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: la clave actual firma msg, ML-DSA-65, 3,309 bytes await client.pqKeyRotate(wallet, newPqPublicKey, 'dilithium3', proof);