@gauntlet-xyz/sdk 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Gauntlet Networks, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,120 @@
+# @gauntlet-xyz/sdk
+
+Official Gauntlet SDK for interacting with Gauntlet-managed vaults — deposits, withdrawals, and on-chain attribution.
+
+## Installation
+
+```bash
+npm install @gauntlet-xyz/sdk viem
+# or
+yarn add @gauntlet-xyz/sdk viem
+```
+
+> `viem` is a required peer dependency.
+
+## Quick start
+
+```ts
+import { GauntletClient } from '@gauntlet-xyz/sdk';
+import { getDepositTx, getWithdrawTx, getVaults, VaultId } from '@gauntlet-xyz/sdk/evm';
+import { createPublicClient, createWalletClient, http } from 'viem';
+import { base } from 'viem/chains';
+import { privateKeyToAccount } from 'viem/accounts';
+
+const publicClient = createPublicClient({ chain: base, transport: http() });
+
+const wallet = createWalletClient({
+  account: privateKeyToAccount('0x...'),
+  chain: base,
+  transport: http(),
+});
+
+const client = new GauntletClient({
+  wallet,
+  evmClients: {
+    [base.id]: publicClient,
+  },
+});
+
+// List available vaults
+const vaults = await getVaults(client, { chainId: base.id });
+
+// Build deposit transaction steps
+const steps = await getDepositTx(client, {
+  vaultId: VaultId.BaseUsdcPrime,
+  chainId: base.id,
+  amount: 1_000_000n, // 1 USDC (6 decimals)
+});
+
+// Execute each step with your wallet
+for (const step of steps) {
+  await wallet.writeContract(step);
+}
+```
+
+## API
+
+### `GauntletClient`
+
+```ts
+new GauntletClient(config: GauntletClientConfig)
+```
+
+| Option | Type | Description |
+|---|---|---|
+| `wallet` | `WalletClient` | Viem wallet client (provides the signer address) |
+| `evmClients` | `Record<number, PublicClient>` | Map of chainId → viem PublicClient |
+| `attributionMode` | `AttributionMode` | `PUBLIC` (default), `ENCODED`, or `PRIVATE` |
+| `builderCode` | `string` | ERC-8021 builder identifier appended to calldata |
+| `apiKey` | `string` | Gauntlet API key (reserved for future use) |
+
+### `getVaults(client, filter?)`
+
+Returns vaults from the bundled manifest. Optionally filter by `chainId` or `protocol`.
+
+### `getDepositTx(client, params)`
+
+Returns an array of `EvmTxStep` objects (approve + deposit) ready to pass to `walletClient.writeContract`.
+
+| Param | Type | Description |
+|---|---|---|
+| `vaultId` | `string` | Vault identifier from the manifest |
+| `amount` | `bigint` | Amount in supply token base units |
+| `chainId` | `number` | Target chain (defaults to Base) |
+| `depositMode` | `string` | `'sync'` or `'async'`; defaults to the vault's configured mode |
+| `receiver` | `Address` | Recipient of vault shares (defaults to wallet address) |
+
+### `getWithdrawTx(client, params)`
+
+Returns an array of `EvmTxStep` objects ready to pass to `walletClient.writeContract`. Specify exactly one of `shares`, `amount`, or `entireAmount: true`.
+
+| Param | Type | Description |
+|---|---|---|
+| `vaultId` | `string` | Vault identifier from the manifest |
+| `chainId` | `number` | Target chain (defaults to Base) |
+| `receiver` | `Address` | Recipient of withdrawn tokens (defaults to wallet address) |
+| `shares` | `bigint` | Redeem a specific number of vault shares |
+| `amount` | `bigint` | Redeem shares worth a specific token amount |
+| `entireAmount` | `true` | Redeem all shares held by the wallet |
+
+## Attribution
+
+The SDK supports ERC-8021 builder attribution. Pass a `builderCode` to the client config and it will be appended to transaction calldata automatically under `AttributionMode.PUBLIC` (the default).
+
+## Error handling
+
+All errors extend `GauntletSDKError` and can be caught by class:
+
+```ts
+import { VaultNotFoundError, AccountRequiredError } from '@gauntlet-xyz/sdk';
+
+try {
+  const steps = await getDepositTx(client, params);
+} catch (e) {
+  if (e instanceof VaultNotFoundError) {
+    console.error('Unknown vault:', e.vaultId);
+  }
+}
+```
+
+Available error classes: `VaultNotFoundError`, `AccountRequiredError`, `RpcNotConfiguredError`, `UnsupportedDepositModeError`, `UnsupportedProtocolError`, `UnsupportedAssetError`, `InvalidWithdrawParamsError`, `ChainMismatchError`, `UnimplementedFeatureError`, `UnitConversionError`.

package/dist/manifest/vaults.json

@@ -0,0 +1,139 @@
+{
+    "version": "2026-03-24",
+    "vaults": [
+        {
+            "vaultId": "baseUsdcPrime",
+            "name": "Gauntlet USDC Prime",
+            "protocol": "morpho",
+            "strategy": "Prime Lending",
+            "deployments": [
+                {
+                    "chain": "evm",
+                    "chainId": 8453,
+                    "vaultAddress": "0xeE8F4eC5672F09119b96Ab6fB59C27E1b7e44b61",
+                    "vaultType": "single-depositor",
+                    "depositMode": "sync",
+                    "supplyToken": [
+                        {
+                            "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+                            "symbol": "USDC",
+                            "decimals": 6
+                        }
+                    ]
+                }
+            ]
+        },
+        {
+            "vaultId": "ethUsdcPrime",
+            "name": "Gauntlet USDC Prime",
+            "protocol": "morpho",
+            "strategy": "Prime Lending",
+            "deployments": [
+                {
+                    "chain": "evm",
+                    "chainId": 1,
+                    "vaultAddress": "0xdd0f28e19C1780eb6396170735D45153D261490d",
+                    "vaultType": "single-depositor",
+                    "depositMode": "sync",
+                    "supplyToken": [
+                        {
+                            "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+                            "symbol": "USDC",
+                            "decimals": 6
+                        }
+                    ]
+                }
+            ]
+        },
+        {
+            "vaultId": "gtusda",
+            "name": "Gauntlet USD Alpha",
+            "protocol": "aera",
+            "strategy": "Multi-strategy Stablecoin Yield",
+            "deployments": [
+                {
+                    "chain": "evm",
+                    "chainId": 8453,
+                    "vaultAddress": "0x000000000001CdB57E58Fa75Fe420a0f4D6640D5",
+                    "provisionerAddress": "0x18CF8d963E1a727F9bbF3AEffa0Bd04FB4dBdA07",
+                    "vaultType": "multi-depositor",
+                    "depositMode": "async",
+                    "supplyToken": [
+                        {
+                            "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+                            "symbol": "USDC",
+                            "decimals": 6
+                        }
+                    ]
+                },
+                {
+                    "chain": "evm",
+                    "chainId": 1,
+                    "vaultAddress": "0x3bd9248048df95db4fbd748c6cd99c1baa40bad0",
+                    "provisionerAddress": "0x74C4A66CE4F4779B11E7c63D42e51EEef3A80D11",
+                    "vaultType": "multi-depositor",
+                    "depositMode": "async",
+                    "supplyToken": [
+                        {
+                            "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+                            "symbol": "USDC",
+                            "decimals": 6
+                        }
+                    ]
+                },
+                {
+                    "chain": "evm",
+                    "chainId": 42161,
+                    "vaultAddress": "0x000000001DC8bd45d7E7829fb1c969cbe4D0D1eC",
+                    "provisionerAddress": "0xDd4a42603E6d8E515C3468789375A98c376821b3",
+                    "vaultType": "multi-depositor",
+                    "depositMode": "async",
+                    "supplyToken": [
+                        {
+                            "address": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
+                            "symbol": "USDC",
+                            "decimals": 6
+                        }
+                    ]
+                },
+                {
+                    "chain": "evm",
+                    "chainId": 10,
+                    "vaultAddress": "0x000000001DC8bd45d7E7829fb1c969cbe4D0D1eC",
+                    "provisionerAddress": "0xCC923371F0d3A9cA75d98E767Df9dE1cdf5799Ef",
+                    "vaultType": "multi-depositor",
+                    "depositMode": "async",
+                    "supplyToken": [
+                        {
+                            "address": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
+                            "symbol": "USDC",
+                            "decimals": 6
+                        }
+                    ]
+                }
+            ]
+        },
+        {
+            "vaultId": "ethUsdcPrimeV2",
+            "name": "Gauntlet USDC Prime v2",
+            "protocol": "morpho",
+            "strategy": "Prime Lending v2",
+            "deployments": [
+                {
+                    "chain": "evm",
+                    "chainId": 1,
+                    "vaultAddress": "0x8c106EEDAd96553e64287A5A6839c3Cc78afA3D0",
+                    "vaultType": "single-depositor",
+                    "depositMode": "sync",
+                    "supplyToken": [
+                        {
+                            "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+                            "symbol": "USDC",
+                            "decimals": 6
+                        }
+                    ]
+                }
+            ]
+        }
+    ]
+}

package/dist/src/attribution/erc8021.d.ts

@@ -0,0 +1,2 @@
+import { type Hex } from 'viem';
+export declare function encodeBuilderCode(builderCode: string): Hex;

package/dist/src/attribution/erc8021.js

@@ -0,0 +1,7 @@
+import { toHex } from 'viem';
+const ERC8021_PREFIX = '8021';
+export function encodeBuilderCode(builderCode) {
+    const codeHex = toHex(builderCode).slice(2);
+    return `0x${ERC8021_PREFIX}${codeHex}`;
+}
+//# sourceMappingURL=erc8021.js.map

package/dist/src/attribution/erc8021.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"erc8021.js","sourceRoot":"","sources":["../../../src/attribution/erc8021.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAY,MAAM,MAAM,CAAC;AAEvC,MAAM,cAAc,GAAG,MAAe,CAAC;AAQvC,MAAM,UAAU,iBAAiB,CAAC,WAAmB;IACnD,MAAM,OAAO,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC5C,OAAO,KAAK,cAAc,GAAG,OAAO,EAAS,CAAC;AAChD,CAAC"}

package/dist/src/attribution/index.d.ts

@@ -0,0 +1,16 @@
+import { Address, type Hex } from 'viem';
+import { GauntletClient } from '../client';
+import { TxStep } from '../evm/adapters/types';
+export { encodeBuilderCode } from './erc8021';
+export type PreparedPayloadWithAttribution = {
+    type: string;
+    to: Address;
+    data: Hex;
+    account?: Address;
+};
+export type PreparedTx = {
+    payload: PreparedPayloadWithAttribution;
+    tx: TxStep;
+};
+export declare function buildAttribution(client: GauntletClient): Promise<Hex>;
+export declare function encodeTransactionWithAttribution(client: GauntletClient, transaction: TxStep): Promise<PreparedTx>;

package/dist/src/attribution/index.js

@@ -0,0 +1,37 @@
+import { encodeFunctionData } from 'viem';
+import { encodeBuilderCode } from './erc8021';
+import { AttributionMode } from '../client';
+import { UnimplementedFeatureError } from '../errors';
+export { encodeBuilderCode } from './erc8021';
+export async function buildAttribution(client) {
+    switch (client.attributionMode) {
+        case AttributionMode.PUBLIC:
+            return client.builderCode ? encodeBuilderCode(client.builderCode) : '0x';
+        case AttributionMode.ENCODED:
+            throw new UnimplementedFeatureError('AttributionMode.ENCODED');
+        case AttributionMode.PRIVATE:
+            throw new UnimplementedFeatureError('AttributionMode.PRIVATE');
+    }
+}
+export async function encodeTransactionWithAttribution(client, transaction) {
+    const customAttribution = await buildAttribution(client);
+    const encodedTx = encodeFunctionData({
+        abi: transaction.abi,
+        functionName: transaction.functionName,
+        args: transaction.args,
+    });
+    const encodedTxWithAttribution = `${encodedTx}${customAttribution.replace('0x', '')}`;
+    return {
+        payload: {
+            type: transaction.type,
+            account: transaction.account,
+            to: transaction.address,
+            data: encodedTxWithAttribution,
+        },
+        tx: {
+            ...transaction,
+            attribution: customAttribution,
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/src/attribution/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/attribution/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,kBAAkB,EAAY,MAAM,MAAM,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAkB,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAC;AAEtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAsB9C,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAsB;IAC3D,QAAQ,MAAM,CAAC,eAAe,EAAE,CAAC;QAC/B,KAAK,eAAe,CAAC,MAAM;YACzB,OAAO,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3E,KAAK,eAAe,CAAC,OAAO;YAC1B,MAAM,IAAI,yBAAyB,CAAC,yBAAyB,CAAC,CAAC;QACjE,KAAK,eAAe,CAAC,OAAO;YAC1B,MAAM,IAAI,yBAAyB,CAAC,yBAAyB,CAAC,CAAC;IACnE,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gCAAgC,CACpD,MAAsB,EACtB,WAAmB;IAEnB,MAAM,iBAAiB,GAAG,MAAM,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzD,MAAM,SAAS,GAAG,kBAAkB,CAAC;QACnC,GAAG,EAAE,WAAW,CAAC,GAAG;QACpB,YAAY,EAAE,WAAW,CAAC,YAAY;QACtC,IAAI,EAAE,WAAW,CAAC,IAAI;KACvB,CAAC,CAAC;IACH,MAAM,wBAAwB,GAAG,GAAG,SAAS,GAAG,iBAAiB,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,EAAS,CAAC;IAC7F,OAAO;QACL,OAAO,EAAE;YACP,IAAI,EAAE,WAAW,CAAC,IAAI;YACtB,OAAO,EAAE,WAAW,CAAC,OAAO;YAC5B,EAAE,EAAE,WAAW,CAAC,OAAO;YACvB,IAAI,EAAE,wBAAwB;SAC/B;QACD,EAAE,EAAE;YACF,GAAG,WAAW;YACd,WAAW,EAAE,iBAAiB;SAC/B;KACF,CAAC;AACJ,CAAC"}

package/dist/src/client.d.ts

@@ -0,0 +1,28 @@
+import { type PublicClient, type WalletClient } from 'viem';
+import type { VaultManifest } from './evm/types';
+export declare enum AttributionMode {
+    PUBLIC = "public",
+    ENCODED = "encoded",
+    PRIVATE = "private"
+}
+export type ChainId = string | number;
+export interface GauntletClientConfig {
+    apiKey?: string;
+    evmClients?: Record<ChainId, PublicClient>;
+    attributionMode?: AttributionMode;
+    builderCode?: string;
+    wallet?: WalletClient;
+}
+export declare class GauntletClient {
+    readonly apiKey?: string;
+    readonly builderCode?: string;
+    readonly attributionMode: AttributionMode;
+    readonly evmClients: Record<ChainId, PublicClient>;
+    readonly wallet?: WalletClient;
+    private _manifest;
+    constructor(config: GauntletClientConfig);
+    get manifest(): Promise<VaultManifest>;
+    setManifest(manifest: VaultManifest): void;
+    getPublicClient(chainId?: ChainId): PublicClient;
+    getSourceId(): Promise<string>;
+}

package/dist/src/client.js

@@ -0,0 +1,35 @@
+import bundledManifest from '../manifest/vaults.json';
+import { RpcNotConfiguredError, UnimplementedFeatureError } from './errors';
+import { base } from 'viem/chains';
+export var AttributionMode;
+(function (AttributionMode) {
+    AttributionMode["PUBLIC"] = "public";
+    AttributionMode["ENCODED"] = "encoded";
+    AttributionMode["PRIVATE"] = "private";
+})(AttributionMode || (AttributionMode = {}));
+export class GauntletClient {
+    constructor(config) {
+        this._manifest = bundledManifest;
+        this.apiKey = config.apiKey;
+        this.evmClients = config.evmClients ?? {};
+        this.attributionMode = config.attributionMode ?? AttributionMode.PUBLIC;
+        this.builderCode = config.builderCode;
+        this.wallet = config.wallet;
+    }
+    get manifest() {
+        return Promise.resolve(this._manifest);
+    }
+    setManifest(manifest) {
+        this._manifest = manifest;
+    }
+    getPublicClient(chainId = base.id) {
+        const client = this.evmClients[chainId];
+        if (!client)
+            throw new RpcNotConfiguredError(chainId);
+        return client;
+    }
+    async getSourceId() {
+        throw new UnimplementedFeatureError('getSourceId');
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/src/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AACA,OAAO,eAAe,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAE5E,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AASnC,MAAM,CAAN,IAAY,eAIX;AAJD,WAAY,eAAe;IACzB,oCAAiB,CAAA;IACjB,sCAAmB,CAAA;IACnB,sCAAmB,CAAA;AACrB,CAAC,EAJW,eAAe,KAAf,eAAe,QAI1B;AAwCD,MAAM,OAAO,cAAc;IAUzB,YAAY,MAA4B;QAFhC,cAAS,GAAkB,eAAgC,CAAC;QAGlE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;QAC1C,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,eAAe,IAAI,eAAe,CAAC,MAAM,CAAC;QACxE,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC9B,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACzC,CAAC;IAED,WAAW,CAAC,QAAuB;QACjC,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC5B,CAAC;IAED,eAAe,CAAC,UAAmB,IAAI,CAAC,EAAE;QACxC,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,qBAAqB,CAAC,OAAO,CAAC,CAAC;QACtD,OAAO,MAAM,CAAC;IAChB,CAAC;IAID,KAAK,CAAC,WAAW;QACf,MAAM,IAAI,yBAAyB,CAAC,aAAa,CAAC,CAAC;IACrD,CAAC;CACF"}

package/dist/src/errors.d.ts

@@ -0,0 +1,55 @@
+import { ChainId } from './client';
+export declare class GauntletSDKError extends Error {
+    constructor(message: string);
+}
+export declare class VaultNotFoundError extends GauntletSDKError {
+    readonly vaultId: string;
+    readonly chainId?: ChainId;
+    constructor(vaultId: string, chainId?: ChainId);
+}
+export declare class UnsupportedAssetError extends GauntletSDKError {
+    readonly asset: string;
+    readonly vaultId: string;
+    constructor(asset: string, vaultId: string);
+}
+export declare class ChainMismatchError extends GauntletSDKError {
+    readonly expected: string;
+    readonly received: string;
+    constructor(expected: string, received: string);
+}
+export declare class UnsupportedDepositModeError extends GauntletSDKError {
+    readonly vaultId: string;
+    readonly requested: 'sync' | 'async';
+    readonly available: string;
+    constructor(vaultId: string, requested: 'sync' | 'async', available: string);
+}
+export declare class RpcNotConfiguredError extends GauntletSDKError {
+    readonly chainId: ChainId;
+    constructor(chainId: ChainId);
+}
+export declare class AccountRequiredError extends GauntletSDKError {
+    constructor();
+}
+export declare class UnsupportedProtocolError extends GauntletSDKError {
+    readonly protocol: string;
+    constructor(protocol: string);
+}
+export declare class InvalidWithdrawParamsError extends GauntletSDKError {
+    constructor();
+}
+export declare class UnimplementedFeatureError extends GauntletSDKError {
+    readonly feature: string;
+    constructor(feature: string);
+}
+export declare class UnsupportedFeatureError extends GauntletSDKError {
+    readonly feature: string;
+    constructor(feature: string);
+}
+export declare class UnitConversionError extends GauntletSDKError {
+    readonly vaultAddress: string;
+    constructor(vaultAddress: string);
+}
+export declare class InvalidSlippageBPSError extends GauntletSDKError {
+    readonly slippage: number;
+    constructor(slippage: number);
+}

package/dist/src/errors.js

@@ -0,0 +1,97 @@
+export class GauntletSDKError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'GauntletSDKError';
+    }
+}
+export class VaultNotFoundError extends GauntletSDKError {
+    constructor(vaultId, chainId) {
+        const msg = chainId
+            ? `Vault "${vaultId}" not found on chainId "${chainId}"`
+            : `Vault "${vaultId}" not found`;
+        super(msg);
+        this.name = 'VaultNotFoundError';
+        this.vaultId = vaultId;
+        this.chainId = chainId;
+    }
+}
+export class UnsupportedAssetError extends GauntletSDKError {
+    constructor(asset, vaultId) {
+        super(`Asset "${asset}" is not supported by vault "${vaultId}"`);
+        this.name = 'UnsupportedAssetError';
+        this.asset = asset;
+        this.vaultId = vaultId;
+    }
+}
+export class ChainMismatchError extends GauntletSDKError {
+    constructor(expected, received) {
+        super(`Chain mismatch: expected "${expected}", received "${received}"`);
+        this.name = 'ChainMismatchError';
+        this.expected = expected;
+        this.received = received;
+    }
+}
+export class UnsupportedDepositModeError extends GauntletSDKError {
+    constructor(vaultId, requested, available) {
+        super(`Vault "${vaultId}" does not support ${requested} deposits (available: ${available})`);
+        this.name = 'UnsupportedDepositModeError';
+        this.vaultId = vaultId;
+        this.requested = requested;
+        this.available = available;
+    }
+}
+export class RpcNotConfiguredError extends GauntletSDKError {
+    constructor(chainId) {
+        super(`No client configured for chainId "${chainId}"`);
+        this.name = 'RpcNotConfiguredError';
+        this.chainId = chainId;
+    }
+}
+export class AccountRequiredError extends GauntletSDKError {
+    constructor() {
+        super('No account specified. Provide a wallet in the client config.');
+        this.name = 'AccountRequiredError';
+    }
+}
+export class UnsupportedProtocolError extends GauntletSDKError {
+    constructor(protocol) {
+        super(`Unsupported protocol: "${protocol}"`);
+        this.name = 'UnsupportedProtocolError';
+        this.protocol = protocol;
+    }
+}
+export class InvalidWithdrawParamsError extends GauntletSDKError {
+    constructor() {
+        super('Withdraw requires exactly one of: shares, amount, or all');
+        this.name = 'InvalidWithdrawParamsError';
+    }
+}
+export class UnimplementedFeatureError extends GauntletSDKError {
+    constructor(feature) {
+        super(`Feature not yet implemented: "${feature}"`);
+        this.name = 'UnimplementedFeatureError';
+        this.feature = feature;
+    }
+}
+export class UnsupportedFeatureError extends GauntletSDKError {
+    constructor(feature) {
+        super(`Feature not supported: "${feature}"`);
+        this.name = 'UnimplementedFeatureError';
+        this.feature = feature;
+    }
+}
+export class UnitConversionError extends GauntletSDKError {
+    constructor(vaultAddress) {
+        super(`Failed to convert token units for vault "${vaultAddress}": fee calculator unavailable`);
+        this.name = 'UnitConversionError';
+        this.vaultAddress = vaultAddress;
+    }
+}
+export class InvalidSlippageBPSError extends GauntletSDKError {
+    constructor(slippage) {
+        super(`Slippage not in range of 10000-0; argumet passed: ${slippage}`);
+        this.name = 'IncorrectArgument';
+        this.slippage = slippage;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/errors.js.map

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

package/dist/src/evm/abis/erc20.d.ts

@@ -0,0 +1,40 @@
+export declare const erc20Abi: readonly [{
+    readonly type: "function";
+    readonly name: "approve";
+    readonly inputs: readonly [{
+        readonly name: "spender";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "bool";
+    }];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "allowance";
+    readonly inputs: readonly [{
+        readonly name: "owner";
+        readonly type: "address";
+    }, {
+        readonly name: "spender";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "balanceOf";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+}];

package/dist/src/evm/abis/erc20.js

@@ -0,0 +1,30 @@
+export const erc20Abi = [
+    {
+        type: 'function',
+        name: 'approve',
+        inputs: [
+            { name: 'spender', type: 'address' },
+            { name: 'amount', type: 'uint256' },
+        ],
+        outputs: [{ type: 'bool' }],
+        stateMutability: 'nonpayable',
+    },
+    {
+        type: 'function',
+        name: 'allowance',
+        inputs: [
+            { name: 'owner', type: 'address' },
+            { name: 'spender', type: 'address' },
+        ],
+        outputs: [{ type: 'uint256' }],
+        stateMutability: 'view',
+    },
+    {
+        type: 'function',
+        name: 'balanceOf',
+        inputs: [{ name: 'account', type: 'address' }],
+        outputs: [{ type: 'uint256' }],
+        stateMutability: 'view',
+    },
+];
+//# sourceMappingURL=erc20.js.map

package/dist/src/evm/abis/erc20.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"erc20.js","sourceRoot":"","sources":["../../../../src/evm/abis/erc20.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,SAAS;QACf,MAAM,EAAE;YACN,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;YACpC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE;SACpC;QACD,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAC3B,eAAe,EAAE,YAAY;KAC9B;IACD;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,WAAW;QACjB,MAAM,EAAE;YACN,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;YAClC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;SACrC;QACD,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC9B,eAAe,EAAE,MAAM;KACxB;IACD;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,WAAW;QACjB,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC9C,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC9B,eAAe,EAAE,MAAM;KACxB;CACO,CAAC"}