@heyanon/sdk 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 HeyAnon
+
+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,6 @@
+# HeyAnon SDK
+
+[![Unit Tests](https://github.com/RealWagmi/heyanon-sdk/actions/workflows/unit-tests.yml/badge.svg)](https://github.com/RealWagmi/heyanon-sdk/actions/workflows/unit-tests.yml)
+[![npm version](https://img.shields.io/npm/v/@heyanon/sdk/latest.svg)](https://www.npmjs.com/package/@heyanon/sdk/v/latest)
+
+This code is shared across HeyAnon TypeScript SDKs.

package/dist/adapter/index.d.ts

@@ -0,0 +1,2 @@
+export * from './types';
+export * from './transformers';

package/dist/adapter/transformers/index.d.ts

@@ -0,0 +1 @@
+export * from './toResult';

package/dist/adapter/transformers/toResult.d.ts

@@ -0,0 +1,2 @@
+import { FunctionReturn } from '../types';
+export declare function toResult(data?: string, error?: boolean): FunctionReturn;

package/dist/adapter/transformers/toResult.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/adapter/types.d.ts

@@ -0,0 +1,17 @@
+import { AiTool } from '../ai';
+import { ChainId, SignTransactionProps, TransactionReturn } from '../blockchain';
+import { PublicClient } from 'viem';
+export interface FunctionReturn {
+    readonly success: boolean;
+    readonly data: string;
+}
+export interface FanctionOptions {
+    readonly getProvider: (chainId: ChainId) => PublicClient;
+    readonly signTransactions: (props: SignTransactionProps) => Promise<TransactionReturn>;
+    readonly notify: (message: string) => Promise<any>;
+}
+export interface AdapterExport {
+    readonly tools: AiTool[];
+    readonly functions: Record<string, (args: any, options: FanctionOptions) => PromiseLike<FunctionReturn>>;
+    readonly description: string;
+}

package/dist/ai/index.d.ts

@@ -0,0 +1 @@
+export * from './types';

package/dist/ai/types.d.ts

@@ -0,0 +1,12 @@
+export interface AiToolProps {
+    readonly name: string;
+    readonly [key: string]: unknown;
+}
+export interface AiTool {
+    readonly name: string;
+    readonly description: string;
+    readonly required: string[];
+    readonly props: AiToolProps[];
+    readonly strict?: boolean;
+    readonly additionalProperties?: boolean;
+}

package/dist/blockchain/constants/chainNames.d.ts

@@ -0,0 +1,3 @@
+import { ChainId } from './chains';
+export declare const chainNames: Record<ChainId, string>;
+export declare const allChainNames: string[];

package/dist/blockchain/constants/chains.d.ts

@@ -0,0 +1,20 @@
+export declare enum ChainId {
+    ETHEREUM = 1,
+    OPTIMISM = 10,
+    BSC = 56,
+    GNOSIS = 100,
+    POLYGON = 137,
+    SONIC = 146,
+    FANTOM = 250,
+    ZKSYNC = 324,
+    METIS = 1088,
+    KAVA = 2222,
+    BASE = 8453,
+    IOTA = 8822,
+    AVALANCHE = 43114,
+    ARBITRUM = 42161,
+    ONE_SEPOLIA = 421614,
+    SCROLL = 534352,
+    SEPOLIA = 11155111
+}
+export declare const allChainIds: ChainId[];

package/dist/blockchain/constants/index.d.ts

@@ -0,0 +1,4 @@
+export * from './chains';
+export * from './weth9';
+export * from './chainNames';
+export * from './misc';

package/dist/blockchain/constants/misc.d.ts

@@ -0,0 +1,2 @@
+export declare const NATIVE_ADDRESS = "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE";
+export declare const DEAD_ADDRESS = "0x000000000000000000000000000000000000dEaD";

package/dist/blockchain/constants/weth9.d.ts

@@ -0,0 +1,23 @@
+import { Token } from '@real-wagmi/sdk';
+/**
+ * Known WETH9 implementation addresses, used in our implementation of Ether#wrapped
+ */
+export declare const WETH9: {
+    1: Token;
+    10: Token;
+    56: Token;
+    137: Token;
+    250: Token;
+    324: Token;
+    2222: Token;
+    43114: Token;
+    42161: Token;
+    1088: Token;
+    8453: Token;
+    8822: Token;
+    146: Token;
+    11155111: Token;
+    421614: Token;
+    534352: Token;
+    100: Token;
+};

package/dist/blockchain/helpers/getChainFromName.d.ts

@@ -0,0 +1,2 @@
+import { ChainId } from '../constants';
+export declare function getChainFromName(chainName: string): ChainId;

package/dist/blockchain/helpers/getChainFromName.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/blockchain/helpers/getChainName.d.ts

@@ -0,0 +1,2 @@
+import { ChainId } from '../constants';
+export declare function getChainName(chainId: ChainId): string;

package/dist/blockchain/helpers/getChainName.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/blockchain/helpers/getWrappedNative.d.ts

@@ -0,0 +1,3 @@
+import { Token } from '@real-wagmi/sdk';
+import { ChainId } from '../constants';
+export declare function getWrappedNative(chainId: ChainId): Token;

package/dist/blockchain/helpers/getWrappedNative.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/blockchain/helpers/index.d.ts

@@ -0,0 +1,3 @@
+export * from './getChainName';
+export * from './getChainFromName';
+export * from './getWrappedNative';

package/dist/blockchain/index.d.ts

@@ -0,0 +1,3 @@
+export * from './constants';
+export * from './helpers';
+export * from './types';

package/dist/blockchain/types.d.ts

@@ -0,0 +1,20 @@
+import { Address, Hex } from 'viem';
+export interface TransactionParams {
+    readonly target: Address;
+    readonly data: Hex;
+    readonly value?: bigint;
+    readonly gas?: bigint;
+}
+export interface TransactionReturnData {
+    readonly message: string;
+    readonly hash: Hex;
+}
+export interface TransactionReturn {
+    readonly isMultisig: boolean;
+    readonly data: TransactionReturnData[];
+}
+export interface SignTransactionProps {
+    readonly chainId: number;
+    readonly account: Address;
+    readonly transactions: TransactionParams[];
+}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './adapter';
+export * from './ai';
+export * from './blockchain';
+export * from './utils';

package/dist/index.js

@@ -0,0 +1,143 @@
+'use strict';
+
+var sdk = require('@real-wagmi/sdk');
+
+// src/adapter/transformers/toResult.ts
+function toResult(data = "", error = false) {
+  return {
+    success: !error,
+    data: error ? `ERROR: ${data}` : data
+  };
+}
+
+// src/blockchain/constants/chains.ts
+var ChainId = /* @__PURE__ */ ((ChainId3) => {
+  ChainId3[ChainId3["ETHEREUM"] = 1] = "ETHEREUM";
+  ChainId3[ChainId3["OPTIMISM"] = 10] = "OPTIMISM";
+  ChainId3[ChainId3["BSC"] = 56] = "BSC";
+  ChainId3[ChainId3["GNOSIS"] = 100] = "GNOSIS";
+  ChainId3[ChainId3["POLYGON"] = 137] = "POLYGON";
+  ChainId3[ChainId3["SONIC"] = 146] = "SONIC";
+  ChainId3[ChainId3["FANTOM"] = 250] = "FANTOM";
+  ChainId3[ChainId3["ZKSYNC"] = 324] = "ZKSYNC";
+  ChainId3[ChainId3["METIS"] = 1088] = "METIS";
+  ChainId3[ChainId3["KAVA"] = 2222] = "KAVA";
+  ChainId3[ChainId3["BASE"] = 8453] = "BASE";
+  ChainId3[ChainId3["IOTA"] = 8822] = "IOTA";
+  ChainId3[ChainId3["AVALANCHE"] = 43114] = "AVALANCHE";
+  ChainId3[ChainId3["ARBITRUM"] = 42161] = "ARBITRUM";
+  ChainId3[ChainId3["ONE_SEPOLIA"] = 421614] = "ONE_SEPOLIA";
+  ChainId3[ChainId3["SCROLL"] = 534352] = "SCROLL";
+  ChainId3[ChainId3["SEPOLIA"] = 11155111] = "SEPOLIA";
+  return ChainId3;
+})(ChainId || {});
+var allChainIds = Object.values(ChainId).filter((value) => typeof value === "number");
+var WETH9 = {
+  [1 /* ETHEREUM */]: sdk.ethereumTokens.weth,
+  [10 /* OPTIMISM */]: sdk.optimismTokens.weth,
+  [56 /* BSC */]: sdk.bscTokens.wbnb,
+  [137 /* POLYGON */]: sdk.polygonTokens.wmatic,
+  [250 /* FANTOM */]: sdk.fantomTokens.wftm,
+  [324 /* ZKSYNC */]: sdk.zkSyncTokens.weth,
+  [2222 /* KAVA */]: sdk.kavaTokens.wkava,
+  [43114 /* AVALANCHE */]: sdk.avalancheTokens.wavax,
+  [42161 /* ARBITRUM */]: sdk.arbitrumTokens.weth,
+  [1088 /* METIS */]: sdk.metisTokens.wmetis,
+  [8453 /* BASE */]: sdk.baseTokens.weth,
+  [8822 /* IOTA */]: sdk.iotaTokens.wiota,
+  [146 /* SONIC */]: sdk.sonicTokens.ws,
+  [11155111 /* SEPOLIA */]: new sdk.Token(11155111 /* SEPOLIA */, "0x7b79995e5f793a07bc00c21412e50ecae098e7f9", 18, "WETH", "Wrapped Ether"),
+  [421614 /* ONE_SEPOLIA */]: new sdk.Token(421614 /* ONE_SEPOLIA */, "0x980B62Da83eFf3D4576C647993b0c1D7faf17c73", 18, "WETH", "Wrapped Ether"),
+  [534352 /* SCROLL */]: new sdk.Token(534352 /* SCROLL */, "0x5300000000000000000000000000000000000004", 18, "WETH", "Wrapped Ether"),
+  [100 /* GNOSIS */]: new sdk.Token(100 /* GNOSIS */, "0xe91D153E0b41518A2Ce8Dd3D7944Fa863463a97d", 18, "WXDAI", "Wrapped XDAI")
+};
+
+// src/blockchain/constants/chainNames.ts
+var chainNames = {
+  [56 /* BSC */]: "bsc",
+  [1 /* ETHEREUM */]: "ethereum",
+  [324 /* ZKSYNC */]: "zksync",
+  [10 /* OPTIMISM */]: "optimistic",
+  [137 /* POLYGON */]: "polygon",
+  [250 /* FANTOM */]: "fantom",
+  [2222 /* KAVA */]: "kava",
+  [43114 /* AVALANCHE */]: "avalanche",
+  [42161 /* ARBITRUM */]: "arbitrum-one",
+  [1088 /* METIS */]: "metis",
+  [8453 /* BASE */]: "base",
+  [8822 /* IOTA */]: "iota",
+  [11155111 /* SEPOLIA */]: "sepolia",
+  [146 /* SONIC */]: "sonic",
+  [100 /* GNOSIS */]: "gnosis",
+  [534352 /* SCROLL */]: "scroll",
+  [421614 /* ONE_SEPOLIA */]: "one-sepolia"
+};
+var allChainNames = Object.values(chainNames);
+
+// src/blockchain/constants/misc.ts
+var NATIVE_ADDRESS = "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE";
+var DEAD_ADDRESS = "0x000000000000000000000000000000000000dEaD";
+
+// src/blockchain/helpers/getChainName.ts
+function getChainName(chainId) {
+  const name = chainNames[chainId];
+  if (!name)
+    throw new Error(`Chain name with id ${chainId} not found`);
+  return name;
+}
+
+// src/blockchain/helpers/getChainFromName.ts
+function getChainFromName(chainName) {
+  for (const [chainId, name] of Object.entries(chainNames)) {
+    if (name === chainName) {
+      return parseInt(chainId);
+    }
+  }
+  throw new Error(`Unknown chain name: ${chainName}`);
+}
+
+// src/blockchain/helpers/getWrappedNative.ts
+function getWrappedNative(chainId) {
+  const token = WETH9[chainId];
+  if (!token) {
+    throw new Error(`Wrapped native for chainId ${chainId} not found`);
+  }
+  return token;
+}
+
+// src/utils/retry.ts
+function delay(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function retry(fn, options) {
+  const { retries = 0, delayMs } = options ?? {};
+  try {
+    return await fn();
+  } catch (error) {
+    if (retries > 0) {
+      if (delayMs) {
+        await delay(delayMs);
+      }
+      return await retry(fn, { ...options, retries: retries - 1 });
+    } else {
+      throw error;
+    }
+  }
+}
+
+// src/utils/sleep.ts
+var sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+
+exports.ChainId = ChainId;
+exports.DEAD_ADDRESS = DEAD_ADDRESS;
+exports.NATIVE_ADDRESS = NATIVE_ADDRESS;
+exports.WETH9 = WETH9;
+exports.allChainIds = allChainIds;
+exports.allChainNames = allChainNames;
+exports.chainNames = chainNames;
+exports.getChainFromName = getChainFromName;
+exports.getChainName = getChainName;
+exports.getWrappedNative = getWrappedNative;
+exports.retry = retry;
+exports.sleep = sleep;
+exports.toResult = toResult;

package/dist/index.mjs

@@ -0,0 +1,129 @@
+import { ethereumTokens, optimismTokens, bscTokens, polygonTokens, fantomTokens, zkSyncTokens, kavaTokens, avalancheTokens, arbitrumTokens, metisTokens, baseTokens, iotaTokens, sonicTokens, Token } from '@real-wagmi/sdk';
+
+// src/adapter/transformers/toResult.ts
+function toResult(data = "", error = false) {
+  return {
+    success: !error,
+    data: error ? `ERROR: ${data}` : data
+  };
+}
+
+// src/blockchain/constants/chains.ts
+var ChainId = /* @__PURE__ */ ((ChainId3) => {
+  ChainId3[ChainId3["ETHEREUM"] = 1] = "ETHEREUM";
+  ChainId3[ChainId3["OPTIMISM"] = 10] = "OPTIMISM";
+  ChainId3[ChainId3["BSC"] = 56] = "BSC";
+  ChainId3[ChainId3["GNOSIS"] = 100] = "GNOSIS";
+  ChainId3[ChainId3["POLYGON"] = 137] = "POLYGON";
+  ChainId3[ChainId3["SONIC"] = 146] = "SONIC";
+  ChainId3[ChainId3["FANTOM"] = 250] = "FANTOM";
+  ChainId3[ChainId3["ZKSYNC"] = 324] = "ZKSYNC";
+  ChainId3[ChainId3["METIS"] = 1088] = "METIS";
+  ChainId3[ChainId3["KAVA"] = 2222] = "KAVA";
+  ChainId3[ChainId3["BASE"] = 8453] = "BASE";
+  ChainId3[ChainId3["IOTA"] = 8822] = "IOTA";
+  ChainId3[ChainId3["AVALANCHE"] = 43114] = "AVALANCHE";
+  ChainId3[ChainId3["ARBITRUM"] = 42161] = "ARBITRUM";
+  ChainId3[ChainId3["ONE_SEPOLIA"] = 421614] = "ONE_SEPOLIA";
+  ChainId3[ChainId3["SCROLL"] = 534352] = "SCROLL";
+  ChainId3[ChainId3["SEPOLIA"] = 11155111] = "SEPOLIA";
+  return ChainId3;
+})(ChainId || {});
+var allChainIds = Object.values(ChainId).filter((value) => typeof value === "number");
+var WETH9 = {
+  [1 /* ETHEREUM */]: ethereumTokens.weth,
+  [10 /* OPTIMISM */]: optimismTokens.weth,
+  [56 /* BSC */]: bscTokens.wbnb,
+  [137 /* POLYGON */]: polygonTokens.wmatic,
+  [250 /* FANTOM */]: fantomTokens.wftm,
+  [324 /* ZKSYNC */]: zkSyncTokens.weth,
+  [2222 /* KAVA */]: kavaTokens.wkava,
+  [43114 /* AVALANCHE */]: avalancheTokens.wavax,
+  [42161 /* ARBITRUM */]: arbitrumTokens.weth,
+  [1088 /* METIS */]: metisTokens.wmetis,
+  [8453 /* BASE */]: baseTokens.weth,
+  [8822 /* IOTA */]: iotaTokens.wiota,
+  [146 /* SONIC */]: sonicTokens.ws,
+  [11155111 /* SEPOLIA */]: new Token(11155111 /* SEPOLIA */, "0x7b79995e5f793a07bc00c21412e50ecae098e7f9", 18, "WETH", "Wrapped Ether"),
+  [421614 /* ONE_SEPOLIA */]: new Token(421614 /* ONE_SEPOLIA */, "0x980B62Da83eFf3D4576C647993b0c1D7faf17c73", 18, "WETH", "Wrapped Ether"),
+  [534352 /* SCROLL */]: new Token(534352 /* SCROLL */, "0x5300000000000000000000000000000000000004", 18, "WETH", "Wrapped Ether"),
+  [100 /* GNOSIS */]: new Token(100 /* GNOSIS */, "0xe91D153E0b41518A2Ce8Dd3D7944Fa863463a97d", 18, "WXDAI", "Wrapped XDAI")
+};
+
+// src/blockchain/constants/chainNames.ts
+var chainNames = {
+  [56 /* BSC */]: "bsc",
+  [1 /* ETHEREUM */]: "ethereum",
+  [324 /* ZKSYNC */]: "zksync",
+  [10 /* OPTIMISM */]: "optimistic",
+  [137 /* POLYGON */]: "polygon",
+  [250 /* FANTOM */]: "fantom",
+  [2222 /* KAVA */]: "kava",
+  [43114 /* AVALANCHE */]: "avalanche",
+  [42161 /* ARBITRUM */]: "arbitrum-one",
+  [1088 /* METIS */]: "metis",
+  [8453 /* BASE */]: "base",
+  [8822 /* IOTA */]: "iota",
+  [11155111 /* SEPOLIA */]: "sepolia",
+  [146 /* SONIC */]: "sonic",
+  [100 /* GNOSIS */]: "gnosis",
+  [534352 /* SCROLL */]: "scroll",
+  [421614 /* ONE_SEPOLIA */]: "one-sepolia"
+};
+var allChainNames = Object.values(chainNames);
+
+// src/blockchain/constants/misc.ts
+var NATIVE_ADDRESS = "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE";
+var DEAD_ADDRESS = "0x000000000000000000000000000000000000dEaD";
+
+// src/blockchain/helpers/getChainName.ts
+function getChainName(chainId) {
+  const name = chainNames[chainId];
+  if (!name)
+    throw new Error(`Chain name with id ${chainId} not found`);
+  return name;
+}
+
+// src/blockchain/helpers/getChainFromName.ts
+function getChainFromName(chainName) {
+  for (const [chainId, name] of Object.entries(chainNames)) {
+    if (name === chainName) {
+      return parseInt(chainId);
+    }
+  }
+  throw new Error(`Unknown chain name: ${chainName}`);
+}
+
+// src/blockchain/helpers/getWrappedNative.ts
+function getWrappedNative(chainId) {
+  const token = WETH9[chainId];
+  if (!token) {
+    throw new Error(`Wrapped native for chainId ${chainId} not found`);
+  }
+  return token;
+}
+
+// src/utils/retry.ts
+function delay(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function retry(fn, options) {
+  const { retries = 0, delayMs } = options ?? {};
+  try {
+    return await fn();
+  } catch (error) {
+    if (retries > 0) {
+      if (delayMs) {
+        await delay(delayMs);
+      }
+      return await retry(fn, { ...options, retries: retries - 1 });
+    } else {
+      throw error;
+    }
+  }
+}
+
+// src/utils/sleep.ts
+var sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+
+export { ChainId, DEAD_ADDRESS, NATIVE_ADDRESS, WETH9, allChainIds, allChainNames, chainNames, getChainFromName, getChainName, getWrappedNative, retry, sleep, toResult };

package/dist/utils/index.d.ts

@@ -0,0 +1,2 @@
+export * from './retry';
+export * from './sleep';

package/dist/utils/retry.d.ts

@@ -0,0 +1,6 @@
+interface Options {
+    readonly retries?: number;
+    readonly delayMs?: number;
+}
+export declare function retry<T>(fn: () => Promise<T>, options?: Options): Promise<T>;
+export {};

package/dist/utils/retry.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/utils/sleep.d.ts

@@ -0,0 +1 @@
+export declare const sleep: (ms: number) => Promise<unknown>;

package/dist/utils/sleep.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@heyanon/sdk",
+  "version": "1.0.0",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "typings": "dist/index.d.ts",
+  "module": "dist/index.mjs",
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "start": "tsup --watch",
+    "build": "tsup",
+    "test": "vitest --run",
+    "lint": "tsdx lint",
+    "prepare": "yarn build",
+    "size": "size-limit",
+    "analyze": "size-limit --why",
+    "format": "prettier --write \"*/**/*.ts\""
+  },
+  "author": "HeyAnon",
+  "devDependencies": {
+    "@size-limit/preset-small-lib": "^9.0.0",
+    "@types/big.js": "^6.2.0",
+    "@types/jest": "^29.5.12",
+    "husky": "^8.0.3",
+    "size-limit": "^9.0.0",
+    "tsdx": "^0.14.1",
+    "tslib": "^2.6.2",
+    "tsup": "^7.2.0",
+    "typescript": "^5.7.3"
+  },
+  "repository": "https://github.com/RealWagmi/heyanon-sdk.git",
+  "keywords": [
+    "heyanon"
+  ],
+  "dependencies": {
+    "@real-wagmi/sdk": "^1.4.5",
+    "viem": "^2.22.7",
+    "vitest": "^2.1.8"
+  }
+}