@riftresearch/sdk 0.11.1 → 0.12.0

package/dist/index.d.ts

@@ -143,11 +143,12 @@ interface ErrorResponse {
 /**
 * Execution actions - the mechanism by which a step is executed.
 */
-type ExecutionAction = "evm_call" | "btc_transfer";
+type ExecutionAction = "evm_call" | "eip712_sign" | "btc_transfer";
 /**
 * Step kinds grouped by action type.
 */
-type EvmCallKind = "approval" | "transfer_erc20" | "dex_swap";
+type EvmCallKind = "approval" | "transfer_erc20" | "dex_swap" | "cowswap_eth_order";
+type Eip712SignKind = "cowswap_erc20_order";
 type BtcTransferKind = "transfer_btc";
 /**
 * EVM Call step - execute calldata on an EVM chain.
@@ -178,6 +179,33 @@ interface EvmCallStep {
 	venue?: string;
 }
 /**
+* CowSwap order payload signed by the user via EIP-712.
+*/
+interface CowSwapOrderToSign {
+	sellToken: string;
+	buyToken: string;
+	receiver: string;
+	sellAmount: U256;
+	buyAmount: U256;
+	validTo: number;
+	appData: string;
+	feeAmount: U256;
+	kind: "sell" | "buy";
+	partiallyFillable: boolean;
+	sellTokenBalance: "erc20" | "internal" | "external";
+	buyTokenBalance: "erc20" | "internal";
+}
+/**
+* EIP-712 sign step - sign and submit an off-chain order.
+*/
+interface Eip712SignStep {
+	id: string;
+	action: "eip712_sign";
+	kind: Eip712SignKind;
+	chainId: number;
+	orderToSign: CowSwapOrderToSign;
+}
+/**
 * BTC Transfer step - send Bitcoin to an address.
 * Used for: depositing BTC to Rift vault.
 */
@@ -197,7 +225,7 @@ interface BtcTransferStep {
 * Discriminated union of all execution step types.
 * Discriminate on `action` for execution logic, or `kind` for specific handling.
 */
-type ExecutionStep = EvmCallStep | BtcTransferStep;
+type ExecutionStep = EvmCallStep | Eip712SignStep | BtcTransferStep;
 /**
 * Swap response with execution steps that the client must execute.
 */
@@ -375,7 +403,7 @@ type SendBitcoinFn = (params: {
 	/** Amount to send in satoshis */
 	amountSats: string;
 }) => Promise<void>;
-type ExecuteSwapStepType = "approval" | "transaction";
+type ExecuteSwapStepType = "approval" | "transaction" | "signature";
 type ExecuteSwapOnExecuteStepCallback = (type: ExecuteSwapStepType) => void | Promise<void>;
 type ExecuteSwapContext<chain extends Chain2 | undefined = Chain2 | undefined> = {
 	/** Viem PublicClient for reading chain data */
@@ -448,6 +476,7 @@ declare class RiftSdk {
 	* Handles: approval, transfer_evm, dex_swap
 	*/
 	private executeEvmCallStep;
+	private executeEip712SignStep;
 	/**
 	* Execute a BTC transfer step - send BTC to the vault address.
 	*/
@@ -456,6 +485,8 @@ declare class RiftSdk {
 	private buildSwapResult;
 	private buildDexSwapRevertMessage;
 	private resolveDexVenueLabel;
+	private shouldReportStepResult;
+	private getCowSwapApiBase;
 	private assertSufficientBalance;
 	private getAddress;
 	private getRefundAddress;

package/dist/index.js

@@ -246,6 +246,7 @@ function createClient(baseUrl) {
 // src/sdk.ts
 var GAS_LIMIT_MULTIPLIER_NUMERATOR = 3n;
 var GAS_LIMIT_MULTIPLIER_DENOMINATOR = 2n;
+var GPV2_SETTLEMENT = "0x9008d19f58aabd9ed0d60971565aa8510560ab41";
 
 class RiftSdk {
   riftClient;
@@ -352,12 +353,13 @@ class RiftSdk {
           const result = await this.executeStep(step, context, swapResponse.swapId, route);
           this.logDebug("step completed", {
             stepId: step.id,
-            txHash: result.txHash
+            txHash: result.txHash,
+            cowswapOrderId: result.cowswapOrderId
           });
-          if (step.action === "evm_call" && step.kind === "dex_swap" && result.txHash) {
+          if (this.shouldReportStepResult(step, result)) {
             this.logDebug("reporting step result", {
               stepId: step.id,
-              dexSwap: true,
+              kind: "kind" in step ? step.kind : undefined,
               monochain: isMonochain
             });
             this.unwrapEdenResult(await this.riftClient.swap({ swapId: swapResponse.swapId }).tx.post({
@@ -385,6 +387,8 @@ class RiftSdk {
     switch (step.action) {
       case "evm_call":
         return this.executeEvmCallStep(step, context, swapId, route);
+      case "eip712_sign":
+        return this.executeEip712SignStep(step, context);
       case "btc_transfer":
         return this.executeBtcTransferStep(step, context);
     }
@@ -471,7 +475,91 @@ class RiftSdk {
       }
       throw new Error(`EVM step transaction reverted (${effectiveStep.kind}) with hash ${txHash}`);
     }
-    return { txHash };
+    return step.kind === "cowswap_eth_order" ? { txHash, cowswapOrderId: txHash } : { txHash };
+  }
+  async executeEip712SignStep(step, context) {
+    const walletClient = this.requireWalletClient(context);
+    const account = walletClient.account;
+    if (!account) {
+      throw new Error("No account configured on wallet client");
+    }
+    await context.onExecuteStep?.("signature");
+    const signature = await walletClient.signTypedData({
+      account,
+      domain: {
+        name: "Gnosis Protocol",
+        version: "v2",
+        chainId: step.chainId,
+        verifyingContract: GPV2_SETTLEMENT
+      },
+      types: {
+        Order: [
+          { name: "sellToken", type: "address" },
+          { name: "buyToken", type: "address" },
+          { name: "receiver", type: "address" },
+          { name: "sellAmount", type: "uint256" },
+          { name: "buyAmount", type: "uint256" },
+          { name: "validTo", type: "uint32" },
+          { name: "appData", type: "bytes32" },
+          { name: "feeAmount", type: "uint256" },
+          { name: "kind", type: "string" },
+          { name: "partiallyFillable", type: "bool" },
+          { name: "sellTokenBalance", type: "string" },
+          { name: "buyTokenBalance", type: "string" }
+        ]
+      },
+      primaryType: "Order",
+      message: {
+        sellToken: step.orderToSign.sellToken,
+        buyToken: step.orderToSign.buyToken,
+        receiver: step.orderToSign.receiver,
+        sellAmount: BigInt(step.orderToSign.sellAmount),
+        buyAmount: BigInt(step.orderToSign.buyAmount),
+        validTo: step.orderToSign.validTo,
+        appData: step.orderToSign.appData,
+        feeAmount: BigInt(step.orderToSign.feeAmount),
+        kind: step.orderToSign.kind,
+        partiallyFillable: step.orderToSign.partiallyFillable,
+        sellTokenBalance: step.orderToSign.sellTokenBalance,
+        buyTokenBalance: step.orderToSign.buyTokenBalance
+      }
+    });
+    const apiBase = this.getCowSwapApiBase(step.chainId);
+    if (!apiBase) {
+      throw new Error(`CowSwap is not supported on chain ${step.chainId}`);
+    }
+    const response = await fetch(`${apiBase}/api/v1/orders`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        sellToken: step.orderToSign.sellToken,
+        buyToken: step.orderToSign.buyToken,
+        receiver: step.orderToSign.receiver,
+        sellAmount: step.orderToSign.sellAmount,
+        buyAmount: step.orderToSign.buyAmount,
+        validTo: step.orderToSign.validTo,
+        appData: step.orderToSign.appData,
+        feeAmount: step.orderToSign.feeAmount,
+        kind: step.orderToSign.kind,
+        partiallyFillable: step.orderToSign.partiallyFillable,
+        sellTokenBalance: step.orderToSign.sellTokenBalance,
+        buyTokenBalance: step.orderToSign.buyTokenBalance,
+        signingScheme: "eip712",
+        signature,
+        from: account.address
+      })
+    });
+    if (!response.ok) {
+      const errorText = await response.text();
+      throw new Error(`CowSwap order submission failed: ${errorText}`);
+    }
+    const body = await response.json();
+    const uid = body && typeof body === "object" && "uid" in body ? body.uid : undefined;
+    const orderId = typeof body === "string" ? body : typeof uid === "string" ? uid : null;
+    if (!orderId) {
+      throw new Error("CowSwap order submission succeeded but returned no order id");
+    }
+    return { cowswapOrderId: orderId };
   }
   async executeBtcTransferStep(step, context) {
     const sendBitcoin = this.requireSendBitcoin(context);
@@ -525,6 +613,22 @@ class RiftSdk {
     const trimmed = venue.trim();
     return trimmed.length > 0 ? trimmed : "the selected venue";
   }
+  shouldReportStepResult(step, result) {
+    if (step.action === "eip712_sign") {
+      return Boolean(result.cowswapOrderId);
+    }
+    if (step.action === "evm_call") {
+      return (step.kind === "dex_swap" || step.kind === "cowswap_eth_order") && (Boolean(result.txHash) || Boolean(result.cowswapOrderId));
+    }
+    return false;
+  }
+  getCowSwapApiBase(chainId) {
+    if (chainId === 1)
+      return "https://api.cow.fi/mainnet";
+    if (chainId === 8453)
+      return "https://api.cow.fi/base";
+    return null;
+  }
   async assertSufficientBalance(currency, amount, context) {
     if (currency.chain.kind !== "EVM")
       return;
@@ -582,7 +686,7 @@ class RiftSdk {
     }
   }
   assertEvmChainMatchForSteps(steps, context) {
-    const evmSteps = steps.filter((step) => step.action === "evm_call");
+    const evmSteps = steps.filter((step) => step.action === "evm_call" || step.action === "eip712_sign");
     const firstStep = evmSteps[0];
     if (!firstStep)
       return;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@riftresearch/sdk",
-	"version": "0.11.1",
+	"version": "0.12.0",
 	"description": "SDK for swapping between bitcoin and evm chains",
 	"license": "MIT",
 	"files": [