@firefly-dao/sdk 1.0.0

package/LICENSE

@@ -0,0 +1,16 @@
+ISC License
+
+Copyright (c) 2025 Firefly Labs
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+

package/README.md

@@ -0,0 +1,265 @@
+# Firefly-SDK
+
+Firefly Labs: The ultimate gateway for lightning-fast, cost-effective cross-chain maneuvers. 
+
+This SDK simplifies how you interact with the Firefly protocol. To get started, browse our <a href="https://docs.fireflylabs.app/developer">docs</a>. For technical setup and configuration, visit the <a href="https://docs.fireflylabs.app/developer">sdk docs</a> to accelerate your build process.
+<br/>
+<br/>
+
+## Installation
+
+You can use the following ways to get the latest version of Firefly SDK:
+
+**npm**
+
+```bash
+npm install @firefly-dao/firefly-sdk
+```
+
+**yarn**
+
+```bash
+yarn add @firefly-dao/firefly-sdk
+```
+
+**pnpm**
+
+```bash
+pnpm add @firefly-dao/firefly-sdk
+```
+
+## Quick Start
+
+### Set up the SDK
+
+```typescript
+import {
+  FireflyClient,
+  MAINNET_FIREFLY_API,
+  TESTNET_FIREFLY_API,
+  LogLevel,
+} from "@firefly-dao/firefly-sdk";
+
+const client = new FireflyClient({
+  baseApiUrl: MAINNET_FIREFLY_API, // or TESTNET_FIREFLY_API
+  referrer: "firefly-sdk", // optional, default: 'firefly-sdk'
+  logLevel: LogLevel.Info, // optional, default: LogLevel.Info
+});
+```
+
+### Get a Quote
+
+```typescript
+const quote = await client.getQuote({
+  fromChainId: 8453,
+  fromTokenAddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", // USDC
+  toChainId: 10,
+  toTokenAddress: "0x0000000000000000000000000000000000000000", // USDC
+  amount: "2000000", // 1 USDC (6 decimals)
+  recipient: "0x...", // destination address
+  sender: "0x...", // optional, source address
+});
+
+// Quote contains:
+// - steps: Transaction steps (approve, deposit)
+// - fees: Fee breakdown (gas, service fees)
+// - details: Rate, impact, time estimate, currencies info
+```
+
+### Execute the Transfer
+
+```typescript
+import { createWalletClient, http } from "viem";
+import { privateKeyToAccount } from "viem/accounts";
+import { base } from "viem/chains";
+
+// Connect wallet
+const wallet = createWalletClient({
+  chain: base,
+  transport: http(),
+  account: privateKeyToAccount(`0x`),
+});
+
+// Execute with progress tracking
+const result = await client.execute({
+  quote,
+  wallet,
+  onProgress: (info) => {
+    console.log(`Step: ${info.step}`);
+    console.log(`Status: ${info.status}`);
+
+    if (info.status === "success") {
+      console.log(`Transaction hash: ${info.hash}`);
+    }
+
+    if (info.status === "failed") {
+      console.error(`Error: ${info.error}`);
+    }
+  },
+});
+
+if (result.status === "success") {
+  console.log("✅ Cross-chain transfer completed!");
+} else {
+  console.error(`❌ Transfer failed: ${result.message}`);
+}
+```
+
+## 📖 API Reference
+
+### FireflyClient Constructor
+
+```typescript
+new FireflyClient(options: FireflyClientOptions)
+```
+
+**Parameters:**
+
+| Parameter    | Type       | Required | Default         | Description                                                   |
+| ------------ | ---------- | -------- | --------------- | ------------------------------------------------------------- |
+| `baseApiUrl` | `string`   | Yes      | -               | API endpoint (`MAINNET_FIREFLY_API` or `TESTNET_FIREFLY_API`) |
+| `referrer`   | `string`   | No       | `'firefly-sdk'` | Application identifier for tracking                           |
+| `logLevel`   | `LogLevel` | No       | `LogLevel.Info` | Logging level (`Info` or `Silent`)                            |
+
+---
+
+### getQuote()
+
+```typescript
+async getQuote(parameters: GetQuoteParameters): Promise<Execute>
+```
+
+Fetches a quote for cross-chain token transfer.
+
+**Parameters:**
+
+| Parameter           | Type     | Required | Description                        |
+| ------------------- | -------- | -------- | ---------------------------------- |
+| `fromChainId`       | `number` | Yes      | Source chain ID                    |
+| `fromTokenAddress`  | `string` | Yes      | Source token contract address      |
+| `toChainId`         | `number` | Yes      | Destination chain ID               |
+| `toTokenAddress`    | `string` | Yes      | Destination token contract address |
+| `amount`            | `string` | Yes      | Amount in smallest unit            |
+| `recipient`         | `string` | Yes      | Recipient address                  |
+| `sender`            | `string` | No       | Sender address                     |
+| `referrer`          | `string` | No       | Referrer                           |
+| `slippageTolerance` | `string` | No       | Cross-chain slip pointID           |
+
+**Returns:**
+
+`Execute` object containing:
+
+- `steps`: Array of transaction steps
+- `fees`: Fee breakdown (gas, service fees)
+- `details`: Transfer details (currencies, rate, impact, time estimate)
+
+---
+
+### execute()
+
+```typescript
+async execute(options: ExecuteOptions): Promise<ExecuteResponse>
+```
+
+Executes the cross-chain transfer.
+
+**Parameters:**
+
+| Parameter    | Type                      | Required | Description                |
+| ------------ | ------------------------- | -------- | -------------------------- |
+| `quote`      | `Execute`                 | Yes      | Quote from `getQuote()`    |
+| `wallet`     | `WalletClient`            | Yes      | Viem wallet client         |
+| `onProgress` | `ExecuteProgressCallback` | No       | Progress callback function |
+
+**Progress Callback:**
+
+```typescript
+interface ExecuteProgressInfo {
+  step: "approve" | "deposit";
+  status: "success" | "failed";
+  hash?: string;
+  error?: any;
+}
+```
+
+**Returns:**
+
+```typescript
+interface ExecuteResponse {
+  status: "idle" | "failed" | "success";
+  message: string;
+}
+```
+
+## Complete Example
+
+```typescript
+import {
+  FireflyClient,
+  MAINNET_FIREFLY_API,
+  LogLevel,
+} from "@firefly-dao/firefly-sdk";
+import { createWalletClient } from "viem";
+import { base } from "viem/chains";
+import { privateKeyToAccount } from "viem/accounts";
+
+async function main() {
+  // 1. Initialize client
+  const client = new FireflyClient({
+    baseApiUrl: MAINNET_FIREFLY_API,
+    referrer: "my-dapp",
+    logLevel: LogLevel.Info,
+  });
+
+  // 2. Setup wallet
+  const wallet = createWalletClient({
+    chain: base,
+    transport: http(),
+    account: privateKeyToAccount(`0x`),
+  });
+
+  try {
+    // 3. Get quote
+    console.log("Getting quote...");
+    const quote = await client.getQuote({
+      fromChainId: 8453, // Base Mainnet
+      fromTokenAddress: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", // Base USDC
+      toChainId: 10, // Optimism Mainnet
+      toTokenAddress: "0x0000000000000000000000000000000000000000", // Optimism USDC
+      amount: "2000000", // 2 USDC (6 decimals)
+      recipient: "0x...", // destination address
+      sender: "0x...", // optional, source address
+    });
+
+    console.log("Quote result:", quote);
+
+    // 4. Execute transfer
+    console.log("Executing transfer...");
+    const result = await client.execute({
+      quote,
+      wallet,
+      onProgress: (info) => {
+        if (info.step === "approve") {
+          console.log("Approval:", info.status);
+        } else if (info.step === "deposit") {
+          console.log("Deposit:", info.status);
+        }
+
+        if (info.hash) {
+          console.log("Transaction:", info.hash);
+        }
+      },
+    });
+
+    if (result.status === "success") {
+      console.log("Transfer completed successfully!");
+    } else {
+      console.error("Transfer failed:", result.message);
+    }
+  } catch (error) {
+    console.error("Error:", error);
+  }
+}
+
+main();
+```

package/_cjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"} 

package/_cjs/src/api/index.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSwapTransferStatusAPI = getSwapTransferStatusAPI;
+exports.actionReportApi = actionReportApi;
+exports.getChainsApi = getChainsApi;
+exports.getTokensApi = getTokensApi;
+exports.postSpeedActionApi = postSpeedActionApi;
+const axios_1 = require("../utils/axios");
+function getSwapTransferStatusAPI({ chainId, hash }) {
+    return axios_1.axios.get('https://api.fireflylabs.app/quote/transaction', {
+        params: {
+            chainId,
+            hash,
+        },
+    });
+}
+function actionReportApi(action) {
+    return axios_1.axios.post('https://api.fireflylabs.app/action', action);
+}
+function getChainsApi() {
+    return axios_1.axios.get('https://api.fireflylabs.app/quote/chains');
+}
+function getTokensApi() {
+    return axios_1.axios.get('https://api.fireflylabs.app/bridge/tokens');
+}
+function postSpeedActionApi(action) {
+    return axios_1.axios.post('https://api.fireflylabs.app/action/speed', action);
+}
+//# sourceMappingURL=index.js.map

package/_cjs/src/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/index.ts"],"names":[],"mappings":";;AAEA,4DAOC;AAED,0CAEC;AAED,oCAEC;AAED,oCAEC;AAED,gDAEC;AAzBD,0CAAuC;AAEvC,SAAgB,wBAAwB,CAAC,EAAE,OAAO,EAAE,IAAI,EAAqC;IAC3F,OAAO,aAAK,CAAC,GAAG,CAAC,+CAA+C,EAAE;QAChE,MAAM,EAAE;YACN,OAAO;YACP,IAAI;SACL;KACF,CAAC,CAAA;AACJ,CAAC;AAED,SAAgB,eAAe,CAAC,MAAW;IACzC,OAAO,aAAK,CAAC,IAAI,CAAC,oCAAoC,EAAE,MAAM,CAAC,CAAA;AACjE,CAAC;AAED,SAAgB,YAAY;IAC1B,OAAO,aAAK,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAA;AAC9D,CAAC;AAED,SAAgB,YAAY;IAC1B,OAAO,aAAK,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAA;AAC/D,CAAC;AAED,SAAgB,kBAAkB,CAAC,MAAW;IAC5C,OAAO,aAAK,CAAC,IAAI,CAAC,0CAA0C,EAAE,MAAM,CAAC,CAAA;AACvE,CAAC"}

package/_cjs/src/client/client.js

@@ -0,0 +1,180 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FireflyClient = void 0;
+const viem_1 = require("viem");
+const axios_1 = require("axios");
+const request_js_1 = require("../utils/request.js");
+const index_js_1 = require("../constants/index.js");
+const index_js_2 = require("../utils/index.js");
+class FireflyClient {
+    constructor({ referrer = 'firefly-sdk', baseApiUrl, logLevel = index_js_1.LogLevel.Info }) {
+        Object.defineProperty(this, "baseApiUrl", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "referrer", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "logLevel", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.referrer = referrer;
+        this.baseApiUrl = baseApiUrl;
+        this.logLevel = logLevel;
+    }
+    async getQuote(parameters) {
+        const { fromChainId, fromTokenAddress, toChainId, toTokenAddress, amount, recipient, sender, slippageTolerance } = parameters;
+        const query = {
+            sender: sender || "0x000000000000000000000000000000000000dead",
+            recipient,
+            fromChainId,
+            fromTokenAddress,
+            toChainId,
+            toTokenAddress,
+            amount,
+            referrer: this.referrer,
+            ...(slippageTolerance && { slippageTolerance: slippageTolerance.toString() }),
+        };
+        const request = {
+            url: `${this.baseApiUrl}/quote`,
+            method: 'post',
+            data: query,
+        };
+        const res = await axios_1.default.request(request);
+        if (res.data.code !== 200) {
+            throw new request_js_1.APIError(res?.data?.message, res.status, res.data);
+        }
+        return { ...res.data.data, request };
+    }
+    async execute({ quote, wallet, onProgress }) {
+        let response = {
+            status: 'idle',
+            message: 'execute function: transaction execution incomplete'
+        };
+        const quoteRequest = quote.request;
+        if (!quoteRequest) {
+            return {
+                status: 'failed',
+                message: 'execute function: quote request information is missing',
+            };
+        }
+        const publicClient = (0, viem_1.createPublicClient)({
+            chain: wallet.chain,
+            transport: (0, viem_1.http)(),
+        });
+        for (let i = 0; i < quote.steps.length; i++) {
+            const step = quote.steps[i];
+            if (step.id === 'approve') {
+                try {
+                    this.logs('Starting approval...');
+                    const params = (0, index_js_2.handleWaitTransactionReceiptParams)(step);
+                    const approveHash = await wallet.sendTransaction(params);
+                    this.logs(`Approval tx hash: ${approveHash}.`);
+                    await publicClient.waitForTransactionReceipt({
+                        hash: approveHash,
+                    });
+                    this.logs('Approval successful');
+                    onProgress?.({ step: 'approve', status: 'success', hash: approveHash });
+                }
+                catch (error) {
+                    onProgress?.({ step: 'approve', status: 'failed', error });
+                    return {
+                        status: 'failed',
+                        message: `execute function approve step failed: ${error}`,
+                    };
+                }
+            }
+            else if (step.id === 'deposit') {
+                this.logs('Starting deposit...');
+                const txData = step.data;
+                const params = {
+                    to: txData.to,
+                    value: BigInt(txData.value),
+                    data: txData.data,
+                    chainId: txData.chainId,
+                    kzg: undefined,
+                };
+                if (txData.maxFeePerGas)
+                    params.maxFeePerGas = BigInt(txData.maxFeePerGas);
+                if (txData.maxPriorityFeePerGas)
+                    params.maxPriorityFeePerGas = BigInt(txData.maxPriorityFeePerGas);
+                if (txData.gasLimit)
+                    params.gasLimit = BigInt(txData.gasLimit);
+                let tx;
+                try {
+                    tx = await wallet.sendTransaction(params);
+                    (0, axios_1.default)({
+                        method: "POST",
+                        url: `${index_js_1.MAINNET_FIREFLY_API}/action`,
+                        data: {
+                            chainId: txData.chainId,
+                            dstChainId: quoteRequest.data.toChainId,
+                            hash: tx,
+                            wallet: wallet?.account?.address,
+                            dstWallet: quoteRequest.data.recipient,
+                            fromToken: quoteRequest.data.fromTokenAddress,
+                            dstToken: quoteRequest.data.toTokenAddress,
+                        },
+                    });
+                    this.logs(`Deposit tx hash: ${tx}.`);
+                }
+                catch (err) {
+                    onProgress?.({ step: 'deposit', status: 'failed', error: err });
+                    return {
+                        status: 'failed',
+                        message: `execute function deposit step failed: ${err}`,
+                    };
+                }
+                try {
+                    while (true) {
+                        await new Promise((resolve) => setTimeout(resolve, 1 * 1000));
+                        const transaction = await (0, axios_1.default)({
+                            method: "GET",
+                            url: `${this.baseApiUrl}/quote/transaction`,
+                            params: {
+                                chainId: quoteRequest.data.fromChainId,
+                                hash: tx,
+                            },
+                        });
+                        if (transaction.data.data.status !== 1) {
+                            continue;
+                        }
+                        else if (transaction.data.data.status === 1) {
+                            this.logs('Deposit successful.');
+                            this.logs(`Cross-chain successful. Tx hash: ${transaction.data.data.dstHash}.`);
+                            onProgress?.({ step: 'deposit', status: 'success', hash: transaction.data.data.dstHash });
+                            response = {
+                                status: 'success',
+                                message: 'transaction successful'
+                            };
+                        }
+                        break;
+                    }
+                }
+                catch (err) {
+                    onProgress?.({ step: 'deposit', status: 'failed', error: err });
+                    return {
+                        status: 'failed',
+                        message: `execute function check transaction status failed: ${err}`,
+                    };
+                }
+            }
+        }
+        return response;
+    }
+    async logs(message) {
+        if (this.logLevel === index_js_1.LogLevel.Info) {
+            console.log(message);
+        }
+    }
+}
+exports.FireflyClient = FireflyClient;
+//# sourceMappingURL=client.js.map

package/_cjs/src/client/client.js.map

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

package/_cjs/src/constants/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LogLevel = exports.TESTNET_FIREFLY_API = exports.MAINNET_FIREFLY_API = void 0;
+exports.MAINNET_FIREFLY_API = 'https://api.fireflylabs.app';
+exports.TESTNET_FIREFLY_API = 'https://api.testnets.fireflylabs.app';
+var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["Info"] = 1] = "Info";
+    LogLevel[LogLevel["None"] = 0] = "None";
+})(LogLevel || (exports.LogLevel = LogLevel = {}));
+//# sourceMappingURL=index.js.map

package/_cjs/src/constants/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/constants/index.ts"],"names":[],"mappings":";;;AAAa,QAAA,mBAAmB,GAAG,6BAA6B,CAAA;AACnD,QAAA,mBAAmB,GAAG,sCAAsC,CAAA;AAGzE,IAAY,QAGX;AAHD,WAAY,QAAQ;IAClB,uCAAQ,CAAA;IACR,uCAAQ,CAAA;AACV,CAAC,EAHW,QAAQ,wBAAR,QAAQ,QAGnB"}

package/_cjs/src/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./client/client.js"), exports);
+tslib_1.__exportStar(require("./constants/index.js"), exports);
+//# sourceMappingURL=index.js.map

package/_cjs/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,6DAAkC;AAClC,+DAAoC"}

package/_cjs/src/test.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const chains_1 = require("viem/chains");
+const client_js_1 = require("./client/client.js");
+const viem_1 = require("viem");
+const accounts_1 = require("viem/accounts");
+const index_js_1 = require("./constants/index.js");
+async function main() {
+    const client = new client_js_1.FireflyClient({
+        baseApiUrl: index_js_1.MAINNET_FIREFLY_API,
+        referrer: 'firefly-sdk',
+        logLevel: index_js_1.LogLevel.Info,
+    });
+    const quote = await client.getQuote({
+        "fromChainId": 8453,
+        "fromTokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+        "recipient": "0x0955e7ad74ca25be76d7309532a40147e08ec8da",
+        "amount": "600000",
+        "toChainId": 42161,
+        "toTokenAddress": "0xaf88d065e77c8cc2239327c5edb3a432268e5831"
+    });
+    console.dir(quote, { depth: null });
+    const wallet = (0, viem_1.createWalletClient)({
+        chain: chains_1.base,
+        transport: (0, viem_1.http)(),
+        account: (0, accounts_1.privateKeyToAccount)(`0x`),
+    });
+    const response = await client.execute({
+        quote,
+        wallet: wallet,
+    });
+    console.dir(response, { depth: null });
+}
+main();
+//# sourceMappingURL=test.js.map

package/_cjs/src/test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.js","sourceRoot":"","sources":["../../src/test.ts"],"names":[],"mappings":";;AAAA,wCAAmC;AACnC,kDAAmD;AACnD,+BAAgD;AAChD,4CAAoD;AACpD,mDAAqE;AAErE,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,IAAI,yBAAa,CAAC;QAC/B,UAAU,EAAE,8BAAmB;QAC/B,QAAQ,EAAE,aAAa;QACvB,QAAQ,EAAE,mBAAQ,CAAC,IAAI;KACxB,CAAC,CAAA;IAEF,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC;QAClC,aAAa,EAAE,IAAI;QACnB,kBAAkB,EAChB,4CAA4C;QAC9C,WAAW,EAAE,4CAA4C;QACzD,QAAQ,EAAE,QAAQ;QAClB,WAAW,EAAE,KAAK;QAClB,gBAAgB,EAAE,4CAA4C;KAC/D,CAAC,CAAA;IAEF,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IAGnC,MAAM,MAAM,GAAG,IAAA,yBAAkB,EAAC;QAChC,KAAK,EAAE,aAAI;QACX,SAAS,EAAE,IAAA,WAAI,GAAE;QACjB,OAAO,EAAE,IAAA,8BAAmB,EAAC,IAAI,CAAC;KACnC,CAAC,CAAA;IAEF,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;QACpC,KAAK;QACL,MAAM,EAAE,MAAM;KACf,CAAC,CAAA;IAEF,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;AACxC,CAAC;AAED,IAAI,EAAE,CAAA"}

package/_cjs/src/types/Execute.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=Execute.js.map

package/_cjs/src/types/Execute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Execute.js","sourceRoot":"","sources":["../../../src/types/Execute.ts"],"names":[],"mappings":""}

package/_cjs/src/types/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./Execute.js"), exports);
+//# sourceMappingURL=index.js.map

package/_cjs/src/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":";;;AAkBA,uDAA4B"}

package/_cjs/src/utils/axios.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.axios = void 0;
+const axios_1 = require("axios");
+const request_js_1 = require("./request.js");
+exports.axios = axios_1.default.create();
+exports.axios.interceptors.response.use((_res) => {
+    if (_res.headers['Deprecation'] === 'true') {
+        console.warn(`Warning: API ${_res.config.url} is deprecated. Stability and performance may be affected.`);
+    }
+    return _res;
+}, (error) => {
+    return Promise.reject(new request_js_1.APIError(error.response?.data?.message, error.response?.data?.statusCode || 500, {
+        ...error.response?.data,
+        endpoint: error.config?.url
+    }));
+});
+//# sourceMappingURL=axios.js.map

package/_cjs/src/utils/axios.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"axios.js","sourceRoot":"","sources":["../../../src/utils/axios.ts"],"names":[],"mappings":";;;AAAA,iCAA0B;AAE1B,6CAAuC;AAE1B,QAAA,KAAK,GAAG,eAAM,CAAC,MAAM,EAAE,CAAA;AAEpC,aAAK,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CAC7B,CAAC,IAAmB,EAAE,EAAE;IACtB,IAAI,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,KAAK,MAAM,EAAE,CAAC;QAC3C,OAAO,CAAC,IAAI,CACV,gBAAgB,IAAI,CAAC,MAAM,CAAC,GAAG,4DAA4D,CAC5F,CAAA;IACH,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC,EACD,CAAC,KAAK,EAAE,EAAE;IACR,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,qBAAQ,CACV,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,EAC7B,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,UAAU,IAAI,GAAG,EACvC;QACE,GAAG,KAAK,CAAC,QAAQ,EAAE,IAAI;QACvB,QAAQ,EAAE,KAAK,CAAC,MAAM,EAAE,GAAG;KAC5B,CACF,CACF,CAAA;AACH,CAAC,CACF,CAAA"}

package/_cjs/src/utils/index.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEcoTypeByChainId = exports.handleWaitTransactionReceiptParams = void 0;
+const handleWaitTransactionReceiptParams = (step) => {
+    const params = {
+        to: step.data.to,
+        from: step.data.from,
+        data: step.data.data,
+        value: BigInt(step.data.value),
+        chainId: step.data.chainId,
+    };
+    if (Number(step.data.gas)) {
+        params.gas = BigInt(step.data.gas);
+    }
+    if (Number(step.data.gasPrice)) {
+        params.gasPrice = BigInt(step.data.gasPrice || '0');
+    }
+    if (Number(step.data.maxFeePerGas)) {
+        params.maxFeePerGas = BigInt(step.data.maxFeePerGas);
+    }
+    if (Number(step.data.maxPriorityFeePerGas)) {
+        params.maxPriorityFeePerGas = BigInt(step.data.maxPriorityFeePerGas);
+    }
+    return params;
+};
+exports.handleWaitTransactionReceiptParams = handleWaitTransactionReceiptParams;
+const getEcoTypeByChainId = (chainId) => {
+    const mapType = {
+        1024001: 'Ton',
+        1024002: 'Fuel',
+        1024003: 'Eclipse',
+        1024004: 'Solana',
+        1024005: 'Soon',
+        1024006: 'Sui',
+        1024007: 'ICP',
+        1024008: 'Tron',
+        1024009: 'Starknet',
+        1024010: 'ZksLite',
+        1024011: 'Movement',
+        1024012: 'SvmBnb',
+        1024013: 'SvmBase',
+        1024014: 'SonicSVM',
+        1024015: 'Aptos',
+    };
+    return mapType?.[chainId] || 'EVM';
+};
+exports.getEcoTypeByChainId = getEcoTypeByChainId;
+//# sourceMappingURL=index.js.map