@realmint/sdk 0.2.0 → 0.2.1

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);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@realmint/sdk",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "TypeScript SDK for the Realmint API — list, buy, and sell tokenized RWAs (non-custodial; the partner's signer signs).",
   "license": "MIT",
   "type": "module",