@realmint/sdk 0.2.3 → 0.3.0

package/README.md

@@ -1,7 +1,7 @@
 # @realmint/sdk
 
-TypeScript SDK for the [Realmint](https://realmint.io) API — **list, buy, and
-sell** tokenized real-world assets. Non-custodial: you inject the signer, the
+TypeScript SDK for the [Realmint](https://realmint.io) API — **list, buy, sell,
+and withdraw** tokenized real-world assets. Non-custodial: you inject the signer, the
 SDK never holds keys. Gas is sponsored in USDC (no native gas needed), and
 funding is over [x402](https://x402.org).
 
@@ -82,6 +82,26 @@ const sold = await client.sellSolana(
 );
 ```
 
+## Withdraw / send
+
+Move funds out of your smart account to any address — gasless (paymaster-sponsored),
+one UserOp signature (same signer as `buy`). Works for both the keyless agent
+identity and Privy human identity.
+
+```ts
+const res = await client.withdraw(
+  {
+    chain_id: 1776,                       // Injective
+    owner_eoa: account.address,
+    token_address: "0xa00C59fF5a080D2b954d0c75e46E22a0c371235a", // native USDC
+    recipient: "0x…",
+    amount_raw: "4800000",                // 4.8 USDC (6 decimals)
+  },
+  signUserOpHash,
+);
+// res.mode === "bundler", res.user_op_hash set
+```
+
 ## Fund with x402
 
 ```ts

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import type { AccountStatus, CreateIntentParams, CreateIntentResponse, ExecuteResponse, GetIntentResponse, Hex, PrepareResponse, PrepareSolanaSellResponse, RealmintClientOptions, RouteIntent, SignSolanaWire, SignUserOpHash } from "./types.js";
+import type { AccountStatus, CreateIntentParams, CreateIntentResponse, ExecuteResponse, GetIntentResponse, Hex, PrepareResponse, PrepareSolanaSellResponse, RealmintClientOptions, RouteIntent, SignSolanaWire, SignUserOpHash, SubmitTransferResponse, WithdrawParams } from "./types.js";
 export declare class RealmintError extends Error {
     readonly status: number;
     readonly body: unknown;
@@ -81,4 +81,12 @@ export declare class RealmintClient {
      * → poll. One Solana signature; gas is relayer-sponsored.
      */
     sellSolana(params: Omit<CreateIntentParams, "action">, signWire: SignSolanaWire, opts?: WaitOptions): Promise<RouteIntent>;
+    /**
+     * Withdraw / send an ERC-20 from the caller's smart account to any address:
+     * prepare → sign the UserOp hash → submit. Gasless (paymaster-sponsored).
+     * Works for both Privy human and keyless-agent identities (the latter requires
+     * the server's `REALMINT_AGENT_WITHDRAW_ENABLED` flag). `sign` is the same
+     * UserOp-hash signer used by `buy`.
+     */
+    withdraw(params: WithdrawParams, sign: SignUserOpHash): Promise<SubmitTransferResponse>;
 }

package/dist/client.js

@@ -239,6 +239,22 @@ export class RealmintClient {
         await this.submitSolanaSell(created.intent_id, signed);
         return this.waitForSettlement(created.intent_id, opts);
     }
+    /**
+     * Withdraw / send an ERC-20 from the caller's smart account to any address:
+     * prepare → sign the UserOp hash → submit. Gasless (paymaster-sponsored).
+     * Works for both Privy human and keyless-agent identities (the latter requires
+     * the server's `REALMINT_AGENT_WITHDRAW_ENABLED` flag). `sign` is the same
+     * UserOp-hash signer used by `buy`.
+     */
+    async withdraw(params, sign) {
+        const prep = await this.request("POST", "/v1/wallet/prepare-transfer", params);
+        const signature = await sign(prep.user_op_hash);
+        const signedUserOp = { ...prep.user_op, signature };
+        return this.request("POST", "/v1/wallet/submit-transfer", {
+            ...params,
+            user_op: signedUserOp,
+        });
+    }
 }
 function safeJson(text) {
     try {

package/dist/types.d.ts

@@ -102,6 +102,30 @@ export interface PrepareSolanaSellResponse {
     /** The Solana pubkey expected to co-sign (the seller's Realmint Wallet). */
     signer: string;
 }
+/** Move an ERC-20 out of the caller's smart account (withdraw / send). */
+export interface WithdrawParams {
+    chain_id: number;
+    /** EOA that owns the smart account (must be the caller's identity). */
+    owner_eoa: string;
+    token_address: string;
+    recipient: string;
+    /** Raw on-chain unit amount (decimal string, e.g. "4800000" for 4.8 USDC). */
+    amount_raw: string;
+}
+export interface PrepareTransferResponse {
+    user_op: UnsignedUserOp;
+    /** EIP-191 personal_sign digest — same shape as a buy's source_user_op_hash. */
+    user_op_hash: Hex;
+    entrypoint_address: string;
+    smart_account_address: string;
+    chain_id: number;
+}
+export interface SubmitTransferResponse {
+    /** "bundler" (source chain) or "direct" (destination chains). */
+    mode: string;
+    user_op_hash: string;
+    tx_hash: string | null;
+}
 /** Terminal-ish states the SDK's waiters stop on. */
 export declare const TERMINAL_STATES: readonly ["completed", "terminal_failed", "expired", "cancelled"];
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@realmint/sdk",
-  "version": "0.2.3",
+  "version": "0.3.0",
   "description": "TypeScript SDK for the Realmint API — list, buy, and sell tokenized RWAs (non-custodial; the partner's signer signs).",
   "license": "MIT",
   "type": "module",
@@ -15,10 +15,6 @@
   "files": [
     "dist"
   ],
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "typecheck": "tsc -p tsconfig.json --noEmit"
-  },
   "keywords": [
     "realmint",
     "rwa",
@@ -31,5 +27,9 @@
   },
   "devDependencies": {
     "typescript": "^5.4.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
   }
-}
+}