@realmint/sdk 0.2.0 → 0.2.2

package/dist/client.d.ts

@@ -56,6 +56,11 @@ export declare class RealmintClient {
     }>;
     /** Submit a signed UserOp directly to the bundler; returns the userOp hash. */
     submitUserOp(bundlerUrl: string, signedUserOp: Record<string, unknown>, entrypoint: string): Promise<Hex>;
+    /**
+     * Poll the bundler for a UserOp receipt until it's mined; returns the source
+     * transaction hash (what `execute` needs). Throws if the UserOp reverts.
+     */
+    waitForUserOp(bundlerUrl: string, userOpHash: Hex, opts?: WaitOptions): Promise<string>;
     private bundlerRpc;
     /** Poll the intent until it reaches a terminal state (or times out). */
     waitForSettlement(intentId: string, opts?: WaitOptions): Promise<RouteIntent>;

package/dist/client.js

@@ -133,6 +133,28 @@ export class RealmintClient {
         ]);
         return result;
     }
+    /**
+     * Poll the bundler for a UserOp receipt until it's mined; returns the source
+     * transaction hash (what `execute` needs). Throws if the UserOp reverts.
+     */
+    async waitForUserOp(bundlerUrl, userOpHash, opts = {}) {
+        const timeoutMs = opts.timeoutMs ?? 120_000;
+        const pollMs = opts.pollMs ?? 2_000;
+        const deadline = Date.now() + timeoutMs;
+        while (Date.now() < deadline) {
+            const receipt = (await this.bundlerRpc(bundlerUrl, "eth_getUserOperationReceipt", [
+                userOpHash,
+            ]));
+            if (receipt) {
+                if (receipt.success === false) {
+                    throw new RealmintError("Source UserOp reverted on-chain", 200, receipt);
+                }
+                return receipt.receipt?.transactionHash ?? userOpHash;
+            }
+            await sleep(pollMs);
+        }
+        throw new RealmintError(`Timed out waiting for UserOp ${userOpHash} to be mined`, 408, null);
+    }
     async bundlerRpc(bundlerUrl, method, params) {
         const res = await this.fetchImpl(bundlerUrl, {
             method: "POST",
@@ -184,9 +206,13 @@ export class RealmintClient {
         const signedUserOp = { ...prep.source_user_op, signature };
         const entrypoint = prep.entrypoint_address ?? account.entrypoint_address;
         const userOpHash = await this.submitUserOp(account.bundler_url, signedUserOp, entrypoint);
+        // `execute` requires the source tx to be MINED (else 400 source_tx_not_mined);
+        // a UserOp hash is not a tx hash. Wait for inclusion, then execute with the
+        // real source tx hash before the quote expires.
+        const sourceTxHash = await this.waitForUserOp(account.bundler_url, userOpHash, opts);
         await this.executeIntent(created.intent_id, {
             agent_wallet: params.agent_wallet,
-            source_tx_hash: userOpHash,
+            source_tx_hash: sourceTxHash,
         });
         return this.waitForSettlement(created.intent_id, opts);
     }
@@ -205,9 +231,11 @@ export class RealmintClient {
      * → poll. One Solana signature; gas is relayer-sponsored.
      */
     async sellSolana(params, signWire, opts = {}) {
-        const created = await this.createIntent({ ...params, action: "sell" });
+        // destination_chain_id 0 selects the Solana sell lane (else the deployment
+        // lookup excludes Solana and 422s with no_sell_deployment).
+        const created = await this.createIntent({ destination_chain_id: 0, ...params, action: "sell" });
         const prep = await this.prepareSolanaSell(created.intent_id);
-        const signed = await signWire(prep.unsigned_tx_wire_base64);
+        const signed = await signWire(prep.transaction);
         await this.submitSolanaSell(created.intent_id, signed);
         return this.waitForSettlement(created.intent_id, opts);
     }

package/dist/types.d.ts

@@ -96,11 +96,11 @@ export interface GetIntentResponse {
     steps: unknown[];
 }
 export interface PrepareSolanaSellResponse {
-    intent_id: string;
-    /** Base64 V0 transaction wire, partially signed; the user co-signs it. */
-    unsigned_tx_wire_base64: string;
-    min_usdc_out: number | string;
-    expected_signer: string;
+    /** Base64 V0 transaction wire, partially signed (relayer); the user co-signs it. */
+    transaction: string;
+    min_usdc_out_raw: string;
+    /** The Solana pubkey expected to co-sign (the seller's Realmint Wallet). */
+    signer: string;
 }
 /** 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.0",
+  "version": "0.2.2",
   "description": "TypeScript SDK for the Realmint API — list, buy, and sell tokenized RWAs (non-custodial; the partner's signer signs).",
   "license": "MIT",
   "type": "module",