@zircuit/ovault-evm 0.0.1

package/dist/types.d.ts

@@ -0,0 +1,202 @@
+import { Chain as ViemChain } from "viem";
+import { OFTAbi } from "./contracts/OFT";
+import { OVaultComposerSyncAbi } from "./contracts/OVaultComposerSync";
+import { ERC4626_ABI } from "./contracts/ERC4626";
+import type { SupportedChainName, SupportedToken } from "./addresses";
+export declare enum OVaultSyncOperations {
+    DEPOSIT = "deposit",
+    REDEEM = "redeem"
+}
+export type OVaultWithdrawalInfo = {
+    index: bigint | number | string;
+    initiator: `0x${string}`;
+};
+export type OVaultMessageWithTxHash = {
+    source?: {
+        tx?: {
+            txHash?: `0x${string}`;
+        };
+    };
+};
+export interface SendParamsInput {
+    srcEid: number;
+    hubEid: number;
+    dstEid: number;
+    dstAddress: `0x${string}`;
+    walletAddress: `0x${string}`;
+    referralCode?: string;
+    vaultAddress: `0x${string}`;
+    oftHubAddress: `0x${string}`;
+    composerAddress: `0x${string}`;
+    vaultTokenAddress: `0x${string}`;
+    hubChain: ViemChain;
+    sourceChain: ViemChain;
+    operation: OVaultSyncOperations;
+    amount: bigint;
+    tokenHubDecimals?: number;
+    dstAmount: bigint;
+    minDstAmount: bigint;
+    slippage: number;
+    oftAddress: `0x${string}`;
+    tokenAddress: `0x${string}`;
+    supportsEip2612?: boolean;
+    requiresZeroApprovalReset?: boolean;
+    hubLzComposeGasLimit?: bigint;
+    buffer?: number;
+    hubRpcUrl?: string;
+    sourceRpcUrl?: string;
+}
+export type GenerateOVaultSyncInputsProps = Omit<SendParamsInput, "dstAmount" | "minDstAmount" | "dstAddress" | "hubChainSourceAmount" | "amount"> & {
+    amount: string;
+    tokenLocalDecimals: number;
+    dstAddress?: `0x${string}`;
+};
+/**
+ * Simplified input for `generateOVaultInputs`. The SDK resolves all contract
+ * addresses, EIDs, chain objects, and decimals from the built-in registry.
+ *
+ * @example
+ * ```ts
+ * const result = await OVaultSyncMessageBuilder.generateOVaultInputs({
+ *   sourceChain: "ethereum",
+ *   destinationChain: "base",
+ *   token: "USDC",
+ *   operation: OVaultSyncOperations.DEPOSIT,
+ *   amount: "100",
+ *   walletAddress: "0x...",
+ * });
+ * ```
+ */
+export interface OVaultCoreInputs {
+    /** Chain where the user submits the transaction */
+    sourceChain: SupportedChainName;
+    /** Chain where tokens/shares are delivered */
+    destinationChain: SupportedChainName;
+    /** Token to deposit or redeem */
+    token: SupportedToken;
+    /** Deposit or redeem */
+    operation: OVaultSyncOperations;
+    /** Human-readable amount (e.g. "100" or "1.5") */
+    amount: string;
+    /** User's wallet address */
+    walletAddress: `0x${string}`;
+    /** Destination address (defaults to walletAddress) */
+    dstAddress?: `0x${string}`;
+    /** Slippage tolerance as a decimal (0.01 = 1%). Defaults to 0.01. */
+    slippage?: number;
+    /** Extra percentage buffer on the message fee. Defaults to 0.3 (30%). */
+    buffer?: number;
+    /** Whether the token supports EIP-2612 permit. Defaults to false. */
+    supportsEip2612?: boolean;
+    /** Override the LZ compose gas limit for cross-chain operations. */
+    hubLzComposeGasLimit?: bigint;
+    /** Referral code */
+    referralCode?: string;
+    /** Custom RPC URLs keyed by chain name. Avoids public RPC rate limits. */
+    rpcUrls?: Partial<Record<SupportedChainName, string>>;
+}
+/**
+ * The send parameters for the OVault. Pass this to the OFT or OVaultComposer to send the tokens.
+ *
+ * @typedef {Object} SendParams
+ * @property {number} dstEid - The destination chain ID.
+ * @property {`0x${string}`} to - The address of the destination contract.
+ * @property {bigint} amountLD - The amount of tokens to send.
+ * @property {bigint} minAmountLD - The minimum amount of tokens to receive.
+ * @property {`0x${string}`} extraOptions - The extra options for the OVault.
+ * @property {`0x${string}`} composeMsg - The compose message for the OVault.
+ * @property {`0x${string}`} oftCmd - The OFT command for the OVault.
+ */
+export interface SendParams {
+    dstEid: number;
+    to: `0x${string}`;
+    amountLD: bigint;
+    minAmountLD: bigint;
+    extraOptions: `0x${string}`;
+    composeMsg: `0x${string}`;
+    oftCmd: `0x${string}`;
+}
+/**
+ * The message fee for the OVault.
+ *
+ * @typedef {Object} MessageFee
+ * @property {bigint} nativeFee - The native fee for the OVault.
+ * @property {bigint} lzTokenFee - The LZ token fee for the OVault.
+ */
+export interface MessageFee {
+    nativeFee: bigint;
+    lzTokenFee: bigint;
+}
+/**
+ * The inputs for the OVault.
+ *
+ * @typedef {Object} OVaultInputs
+ * @property {MessageFee} messageFee - The message fee for the OVault.
+ * @property {`0x${string}`} contractAddress - The address of the contract to call.
+ * @property {Object} dstAmount - The amount of tokens to send.
+ * @property {Object} approval - The approval parameters for the OVault. If undefined, then no approval is needed.
+ * @property {Object} txArgs - The transaction arguments for the OVault.
+ */
+export type OVaultSyncInputs = {
+    messageFee: MessageFee;
+    contractAddress: `0x${string}`;
+    dstAmount: {
+        amount: bigint;
+        minAmount: bigint;
+    };
+    approval?: {
+        tokenAddress: `0x${string}`;
+        amount: bigint;
+        spender: `0x${string}`;
+        usePermit?: boolean;
+        nonce?: bigint;
+        tokenName?: string;
+        tokenVersion?: string;
+        needsResetApproval?: boolean;
+    };
+} & ({
+    txArgs: {
+        base: [SendParams, MessageFee, `0x${string}`];
+        permitParams: ["deadline", "v", "r", "s"] | null;
+    };
+    contractFunctionName: "send" | "sendWithPermit";
+    abi: typeof OFTAbi;
+} | {
+    txArgs: {
+        base: [bigint, SendParams, `0x${string}`];
+        permitParams: ["deadline", "v", "r", "s"] | null;
+    };
+    contractFunctionName: "depositAndSendWithPermit" | "depositAndSend" | "redeemAndSend";
+    abi: typeof OVaultComposerSyncAbi;
+} | {
+    txArgs: {
+        base: [bigint, `0x${string}`];
+        permitParams: null;
+    };
+    contractFunctionName: "deposit";
+    abi: typeof ERC4626_ABI;
+} | {
+    txArgs: {
+        base: [bigint, `0x${string}`, `0x${string}`];
+        permitParams: null;
+    };
+    contractFunctionName: "redeem";
+    abi: typeof ERC4626_ABI;
+});
+export declare enum OVaultTransactionStep {
+    SOURCE_CHAIN_TRANSACTION = "sourceChainTransaction",
+    SOURCE_TO_HUB_LZ_TRANSACTION = "sourceToHubLzTransaction",
+    HUB_CHAIN_TRANSACTION = "hubChainTransaction",
+    HUB_TO_DST_LZ_TRANSACTION = "hubToDstLzTransaction",
+    DST_CHAIN_TRANSACTION = "dstChainTransaction",
+    COMPLETED = "completed"
+}
+export declare enum OVaultFailureReason {
+    UNKNOWN = "unknown"
+}
+export interface OVaultTransactionStatus {
+    step: OVaultTransactionStep;
+    failureReason?: OVaultFailureReason;
+    refunded?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,18 @@
+export var OVaultSyncOperations;
+(function (OVaultSyncOperations) {
+    OVaultSyncOperations["DEPOSIT"] = "deposit";
+    OVaultSyncOperations["REDEEM"] = "redeem";
+})(OVaultSyncOperations || (OVaultSyncOperations = {}));
+export var OVaultTransactionStep;
+(function (OVaultTransactionStep) {
+    OVaultTransactionStep["SOURCE_CHAIN_TRANSACTION"] = "sourceChainTransaction";
+    OVaultTransactionStep["SOURCE_TO_HUB_LZ_TRANSACTION"] = "sourceToHubLzTransaction";
+    OVaultTransactionStep["HUB_CHAIN_TRANSACTION"] = "hubChainTransaction";
+    OVaultTransactionStep["HUB_TO_DST_LZ_TRANSACTION"] = "hubToDstLzTransaction";
+    OVaultTransactionStep["DST_CHAIN_TRANSACTION"] = "dstChainTransaction";
+    OVaultTransactionStep["COMPLETED"] = "completed";
+})(OVaultTransactionStep || (OVaultTransactionStep = {}));
+export var OVaultFailureReason;
+(function (OVaultFailureReason) {
+    OVaultFailureReason["UNKNOWN"] = "unknown";
+})(OVaultFailureReason || (OVaultFailureReason = {}));

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@zircuit/ovault-evm",
+  "version": "0.0.1",
+  "description": "Zircuit OVault Implementation SDK",
+  "keywords": [
+    "LayerZero",
+    "Zircuit",
+    "OVault",
+    "ERC4626",
+    "Composer",
+    "OmniChain",
+    "EndpointV2",
+    "EVM"
+  ],
+  "repository": "zircuit-labs/ovault-evm",
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/*.js",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src/**/*",
+    "dist/**/*"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "test": "tsx node_modules/mocha/bin/_mocha test/**/*.test.ts"
+  },
+  "dependencies": {
+    "@layerzerolabs/lz-v2-utilities": "^3.0.148",
+    "@layerzerolabs/scan-client-v2": "^0.0.1",
+    "viem": "^2.33.1"
+  },
+  "devDependencies": {
+    "@types/mocha": "^10.0.10",
+    "@types/node": "^24.1.0",
+    "dotenv": "^17.2.3",
+    "mocha": "^11.7.1",
+    "tsx": "^4.20.3",
+    "typescript": "^5.4.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/addresses.ts

@@ -0,0 +1,100 @@
+import type { Chain as ViemChain } from "viem";
+import { mainnet, base } from "viem/chains";
+
+// ---------------------------------------------------------------------------
+// Supported chains
+// ---------------------------------------------------------------------------
+
+export type SupportedChainName = "ethereum" | "base";
+
+export interface ChainMeta {
+  /** LayerZero Endpoint ID */
+  eid: number;
+  /** viem Chain object */
+  viemChain: ViemChain;
+}
+
+export const CHAINS: Record<SupportedChainName, ChainMeta> = {
+  ethereum: { eid: 30101, viemChain: mainnet },
+  base: { eid: 30184, viemChain: base },
+} as const;
+
+// ---------------------------------------------------------------------------
+// Supported tokens
+// ---------------------------------------------------------------------------
+
+export type SupportedToken = "usdc" | "usdt";
+
+// ---------------------------------------------------------------------------
+// Per-token cluster config — hub chain is always Base
+// ---------------------------------------------------------------------------
+
+interface ClusterChainDeployment {
+  /** UnderlyingOFT (hub) or UnderlyingOFTAdapter (spoke) */
+  oft: `0x${string}`;
+  /** Vault (hub) or VaultToken (spoke) */
+  vault: `0x${string}`;
+  /** Underlying ERC-20 token address on this chain */
+  token: `0x${string}`;
+}
+
+interface HubChainDeployment extends ClusterChainDeployment {
+  composer: `0x${string}`;
+}
+
+interface ClusterConfig {
+  hubChain: "base";
+  /** Token decimals on the hub chain */
+  hubDecimals: number;
+  /** Whether the token requires resetting approval to 0 before setting a new value (e.g. USDT) */
+  requiresZeroApprovalReset: boolean;
+  /** Per-chain deployments keyed by chain name */
+  chains: Partial<Record<SupportedChainName, ClusterChainDeployment>> & {
+    /** Hub chain always present and includes composer */
+    base: HubChainDeployment;
+  };
+}
+
+/**
+ * Built-in address registry
+ *
+ * Hub chain is always **Base** for all clusters.
+ */
+export const CLUSTERS: Record<SupportedToken, ClusterConfig> = {
+  usdc: {
+    hubChain: "base",
+    hubDecimals: 6,
+    requiresZeroApprovalReset: false,
+    chains: {
+      base: {
+        oft: "0xd7aBC360dfcF1B6dD0a03138235e12A2bc1c1C8B",
+        vault: "0x03067bbD0d41E3Fe4A0bb6ca67c99e7352Da4CAE",
+        composer: "0xBb801ED781dF31F660cC743bEf7Bb9D04B030923",
+        token: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+      },
+      ethereum: {
+        oft: "0xd58E8c1c83d598aD76B5f0E26B4a25cdB885d190",
+        vault: "0x07C898e77310870770f88d18a01009cB65A1c1a9",
+        token: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+      },
+    },
+  },
+  usdt: {
+    hubChain: "base",
+    hubDecimals: 6,
+    requiresZeroApprovalReset: true,
+    chains: {
+      base: {
+        oft: "0x264D6474802Ef8bc1bc05F89F7d640D1E93c5330",
+        vault: "0x25d90ABd6c1E8DCCD40932D2fdD2Cd381bfc832D",
+        composer: "0x16cE6D9576A411911e62b6073F1cc9d1347ad96B",
+        token: "0x820266ecC2D268B0fBbD2aA3a1bdf28d12582Bbc",
+      },
+      ethereum: {
+        oft: "0x2D342De4c58a871b3525740C58a1C112D5835865",
+        vault: "0x8ADbeA709B31A564f9750A280EC2690aD1cf470A",
+        token: "0xdAC17F958D2ee523a2206206994597C13D831ec7",
+      },
+    },
+  },
+};

package/src/contracts/EIP2612.ts

@@ -0,0 +1,38 @@
+export const EIP2612_ABI = [
+  {
+    inputs: [
+      { name: "owner", type: "address" },
+      { name: "spender", type: "address" },
+      { name: "value", type: "uint256" },
+      { name: "deadline", type: "uint256" },
+      { name: "v", type: "uint8" },
+      { name: "r", type: "bytes32" },
+      { name: "s", type: "bytes32" },
+    ],
+    name: "permit",
+    outputs: [],
+    stateMutability: "nonpayable",
+    type: "function",
+  },
+  {
+    inputs: [{ name: "owner", type: "address" }],
+    name: "nonces",
+    outputs: [{ name: "", type: "uint256" }],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [],
+    name: "DOMAIN_SEPARATOR",
+    outputs: [{ name: "", type: "bytes32" }],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [],
+    name: "version",
+    outputs: [{ name: "", type: "string" }],
+    stateMutability: "view",
+    type: "function",
+  },
+];

package/src/contracts/ERC20.ts

@@ -0,0 +1,222 @@
+export const ERC20Abi = [
+  {
+    constant: true,
+    inputs: [],
+    name: "name",
+    outputs: [
+      {
+        name: "",
+        type: "string",
+      },
+    ],
+    payable: false,
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    constant: false,
+    inputs: [
+      {
+        name: "_spender",
+        type: "address",
+      },
+      {
+        name: "_value",
+        type: "uint256",
+      },
+    ],
+    name: "approve",
+    outputs: [
+      {
+        name: "",
+        type: "bool",
+      },
+    ],
+    payable: false,
+    stateMutability: "nonpayable",
+    type: "function",
+  },
+  {
+    constant: true,
+    inputs: [],
+    name: "totalSupply",
+    outputs: [
+      {
+        name: "",
+        type: "uint256",
+      },
+    ],
+    payable: false,
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    constant: false,
+    inputs: [
+      {
+        name: "_from",
+        type: "address",
+      },
+      {
+        name: "_to",
+        type: "address",
+      },
+      {
+        name: "_value",
+        type: "uint256",
+      },
+    ],
+    name: "transferFrom",
+    outputs: [
+      {
+        name: "",
+        type: "bool",
+      },
+    ],
+    payable: false,
+    stateMutability: "nonpayable",
+    type: "function",
+  },
+  {
+    constant: true,
+    inputs: [],
+    name: "decimals",
+    outputs: [
+      {
+        name: "",
+        type: "uint8",
+      },
+    ],
+    payable: false,
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    constant: true,
+    inputs: [
+      {
+        name: "_owner",
+        type: "address",
+      },
+    ],
+    name: "balanceOf",
+    outputs: [
+      {
+        name: "balance",
+        type: "uint256",
+      },
+    ],
+    payable: false,
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    constant: true,
+    inputs: [],
+    name: "symbol",
+    outputs: [
+      {
+        name: "",
+        type: "string",
+      },
+    ],
+    payable: false,
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    constant: false,
+    inputs: [
+      {
+        name: "_to",
+        type: "address",
+      },
+      {
+        name: "_value",
+        type: "uint256",
+      },
+    ],
+    name: "transfer",
+    outputs: [
+      {
+        name: "",
+        type: "bool",
+      },
+    ],
+    payable: false,
+    stateMutability: "nonpayable",
+    type: "function",
+  },
+  {
+    constant: true,
+    inputs: [
+      {
+        name: "_owner",
+        type: "address",
+      },
+      {
+        name: "_spender",
+        type: "address",
+      },
+    ],
+    name: "allowance",
+    outputs: [
+      {
+        name: "",
+        type: "uint256",
+      },
+    ],
+    payable: false,
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    payable: true,
+    stateMutability: "payable",
+    type: "fallback",
+  },
+  {
+    anonymous: false,
+    inputs: [
+      {
+        indexed: true,
+        name: "owner",
+        type: "address",
+      },
+      {
+        indexed: true,
+        name: "spender",
+        type: "address",
+      },
+      {
+        indexed: false,
+        name: "value",
+        type: "uint256",
+      },
+    ],
+    name: "Approval",
+    type: "event",
+  },
+  {
+    anonymous: false,
+    inputs: [
+      {
+        indexed: true,
+        name: "from",
+        type: "address",
+      },
+      {
+        indexed: true,
+        name: "to",
+        type: "address",
+      },
+      {
+        indexed: false,
+        name: "value",
+        type: "uint256",
+      },
+    ],
+    name: "Transfer",
+    type: "event",
+  },
+] as const;