SDK · TypeScript
Un cliente Node.js para pagos, cuentas, vault, monitorización y x402. ESM y CommonJS, con tipos y sin dependencias de runtime obligatorias.
tilcai-sdk · v0.1.0 · Node.js ≥ 20 · README
Cotizar sin mover fondos
Configura una dirección Stellar válida con trustline de USDC. La cotización consulta la disponibilidad del destinatario; no autoriza ni paga.
import { Tilcai } from "tilcai-sdk";
const tilcai = Tilcai.fromEnv();
await tilcai.verifyEnvironment();
const quote = await tilcai.payments.quote({
source: "monad", // testnet only
amount: "1.25",
payTo: process.env.STELLAR_RECIPIENT!,
});
console.log(quote);Elegir quién firma
| mode | Autorización | Gas |
|---|---|---|
| gasless | Wallet EVM · EIP-3009 / EIP-712 | Relayer |
| account | Passkey de la smart account · ERC-1271 | Relayer |
| external | Wallet difunde approve + burn | Origen: pagador · destino: relayer |
El flujo transaccional usa payments.pay({ from, amount, payTo, signer, idempotencyKey, approve }). No lo ejecutes hasta revisar la cotización y aprobar el movimiento de fondos. viem y @stellar/stellar-sdk son dependencias opcionales para sus respectivos firmantes.
Reintentos y errores
Conserva la clave de idempotencia y el paymentId. Si PaymentError tiene uncertain: true, consulta payments.get(id) o concilia el intento existente; no crees otro pago.
La disponibilidad depende de tu instancia. Consulta /health y /v1/routes antes de integrar.