@sign-global/tokentable-core 1.0.0 → 1.1.0

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @sign-global/tokentable-core
 
+## 1.1.0
+
+### Minor Changes
+
+- feat: update Arbitrum chain configuration
+
+## 0.0.0-beta-20250625021659
+
+### Major Changes
+
+- ✨ feat: add beta version script and improve claim fee calculation
+
+## 0.0.0-beta-20250624084326
+
+### Minor Changes
+
+- ✨ feat: add fee handling for TokenTableMerkleDistributorWithFees
+
 ## 1.0.0
 
 ### Major Changes

package/README.md

@@ -0,0 +1,72 @@
+# TokenTable Core Package
+
+Core utilities and functions for the TokenTable SDK.
+
+## Development
+
+### Testing
+
+This package uses [Vitest](https://vitest.dev/) for testing.
+
+#### Running Tests
+
+```bash
+# Run tests once
+pnpm test:run
+
+# Run tests in watch mode
+pnpm test
+
+# Run tests with UI
+pnpm vitest --ui
+```
+
+#### Test Structure
+
+Tests are located in `src/**/__tests__/` directories following the pattern `*.test.ts`.
+
+#### Current Test Coverage
+
+- `getOrCreateAssociatedTokenAccount` - Comprehensive tests for Solana associated token account creation
+  - Tests existing account retrieval
+  - Tests new account creation when account doesn't exist
+  - Tests error handling for invalid mint/owner
+  - Tests custom parameter handling
+  - Tests unexpected error propagation
+
+### Building
+
+```bash
+# Build the package
+pnpm build
+
+# Build in watch mode
+pnpm build:watch
+```
+
+### Cleaning
+
+```bash
+# Clean build artifacts
+pnpm clean
+```
+
+## Testing Philosophy
+
+The tests use comprehensive mocking to isolate the unit under test while ensuring all code paths are covered. Key testing principles:
+
+1. **Isolation**: External dependencies are mocked to focus on the function logic
+2. **Coverage**: All branches and error conditions are tested
+3. **Realistic Data**: Valid Solana public keys and realistic mock data are used
+4. **Error Handling**: Both expected and unexpected errors are tested
+
+## Dependencies
+
+This package depends on:
+- `@solana/web3.js` - Solana blockchain interaction
+- `@solana/spl-token` - SPL Token program utilities
+- Various other blockchain and utility libraries
+
+Dev dependencies include:
+- `vitest` - Testing framework
+- `jsdom` - DOM environment for tests

package/dist/index.d.mts

@@ -74,7 +74,7 @@ declare const ChainConfig: {
     };
     42161: {
         contractAddress: string;
-        rpcUrl: "https://arb1.arbitrum.io/rpc";
+        rpcUrl: string;
     };
     80085: {
         contractAddress: string;
@@ -1803,6 +1803,7 @@ type IAirdropClaim = {
     data: string;
     leaf: string;
     claimed?: boolean;
+    fees: string;
     claimId?: string;
     claimable?: boolean;
     proofHash: string;
@@ -1812,9 +1813,13 @@ type IAirdropClaim = {
     expired?: boolean;
     project: IProject;
 };
+interface IExtraData {
+    isLegacy: boolean;
+    attestationId: bigint;
+}
 interface IAirdropClaimData extends IAirdropClaim {
-    extraData: any;
-    value: bigint;
+    extraData?: IExtraData;
+    value?: bigint | string;
 }
 type IAirdropSignatureClaim = {
     percent: number;
@@ -2052,7 +2057,7 @@ declare function fetchTokenVersion(tokenAddress: string, options: FetchTokenMeta
 declare const clusterApiUrl: (cluster?: Cluster) => string;
 
 declare const getCustomNaNoId: () => string;
-declare const safeParseJSON: (str: string) => any;
+declare const safeParseJSON: <T = any>(str: string | null | undefined, defaultValue?: T) => T;
 declare const isBeforeByUnix: (unix: number) => boolean;
 declare const delay: (ms: number) => Promise<unknown>;
 declare function retry<T>(fn: () => Promise<T>, options: {
@@ -2101,4 +2106,4 @@ declare const getAvailableClaimAmountForSignature: ({ contractAddress, chainId,
     }[];
 }) => Promise<string | 0>;
 
-export { AirdropSigIdentityTypeEnum, ApiClient, type ApiClientOptions, type ApiRequestOptions, CONST, ChainConfig, type ChainId, ChainType, ETokenType, ErrorCode, AirdropService$2 as EvmAirdropService, EvmAirdropVersionEnum, type EvmContractClientOption, SignatureAirdropService$1 as EvmSignatureAirdropService, type FetchTokenMetadataOptions, type FetchTokenVersionOptions, type IAirdropClaim, type IAirdropClaimData, type IAirdropData, type IAirdropOptions, type IAirdropService, type IAirdropSignatureClaim, type IAirdropSignatureData, type IAirdropSignatureIdentity, type IClaimSignature, type IContractConfig, type IProject, type IProjectExtra, type IWalletClient, type Identity, AirdropService$1 as SolanaAirdropService, SignatureAirdropService as SolanaSignatureAirdropService, SplTokenVersion, type SupportedChainType, SupportedChains, type ThemeConfig, AirdropService as TonAirdropService, TonAirdropVersionEnum, TonWalletService, ZERO_ADDRESS, apiClient, batchCheckClaimedForSignature, bindWallet, checkEligibility, checkGetSignatures, cleanUrlParams, clusterApiUrl, connectGoogleApi, connectTwitter, delay, disconnectRecipient, fetchTokenVersion, flipAddressType, getAirdropContractConfig, getAirdropPro, getAirdropProject, getAirdropProjectId, getAirdropQuery, getAvailableClaimAmountForSignature, getChainById, getChainConfig, getChainRpc, getCustomNaNoId, getJettonInfo, getOrCreateAssociatedTokenAccount, getTonProjectIdByAddress, hexStrToU8Array, isBeforeByUnix, isGreaterThan, isMobile, mevmDevNet, retry, safeParseJSON, safePlus, signBrBTestnet, solanaDevNet, solanaMainNet, tonMainNet, tonTestNet };
+export { AirdropSigIdentityTypeEnum, ApiClient, type ApiClientOptions, type ApiRequestOptions, CONST, ChainConfig, type ChainId, ChainType, ETokenType, ErrorCode, AirdropService$2 as EvmAirdropService, EvmAirdropVersionEnum, type EvmContractClientOption, SignatureAirdropService$1 as EvmSignatureAirdropService, type FetchTokenMetadataOptions, type FetchTokenVersionOptions, type IAirdropClaim, type IAirdropClaimData, type IAirdropData, type IAirdropOptions, type IAirdropService, type IAirdropSignatureClaim, type IAirdropSignatureData, type IAirdropSignatureIdentity, type IClaimSignature, type IContractConfig, type IExtraData, type IProject, type IProjectExtra, type IWalletClient, type Identity, AirdropService$1 as SolanaAirdropService, SignatureAirdropService as SolanaSignatureAirdropService, SplTokenVersion, type SupportedChainType, SupportedChains, type ThemeConfig, AirdropService as TonAirdropService, TonAirdropVersionEnum, TonWalletService, ZERO_ADDRESS, apiClient, batchCheckClaimedForSignature, bindWallet, checkEligibility, checkGetSignatures, cleanUrlParams, clusterApiUrl, connectGoogleApi, connectTwitter, delay, disconnectRecipient, fetchTokenVersion, flipAddressType, getAirdropContractConfig, getAirdropPro, getAirdropProject, getAirdropProjectId, getAirdropQuery, getAvailableClaimAmountForSignature, getChainById, getChainConfig, getChainRpc, getCustomNaNoId, getJettonInfo, getOrCreateAssociatedTokenAccount, getTonProjectIdByAddress, hexStrToU8Array, isBeforeByUnix, isGreaterThan, isMobile, mevmDevNet, retry, safeParseJSON, safePlus, signBrBTestnet, solanaDevNet, solanaMainNet, tonMainNet, tonTestNet };

package/dist/index.d.ts

@@ -74,7 +74,7 @@ declare const ChainConfig: {
     };
     42161: {
         contractAddress: string;
-        rpcUrl: "https://arb1.arbitrum.io/rpc";
+        rpcUrl: string;
     };
     80085: {
         contractAddress: string;
@@ -1803,6 +1803,7 @@ type IAirdropClaim = {
     data: string;
     leaf: string;
     claimed?: boolean;
+    fees: string;
     claimId?: string;
     claimable?: boolean;
     proofHash: string;
@@ -1812,9 +1813,13 @@ type IAirdropClaim = {
     expired?: boolean;
     project: IProject;
 };
+interface IExtraData {
+    isLegacy: boolean;
+    attestationId: bigint;
+}
 interface IAirdropClaimData extends IAirdropClaim {
-    extraData: any;
-    value: bigint;
+    extraData?: IExtraData;
+    value?: bigint | string;
 }
 type IAirdropSignatureClaim = {
     percent: number;
@@ -2052,7 +2057,7 @@ declare function fetchTokenVersion(tokenAddress: string, options: FetchTokenMeta
 declare const clusterApiUrl: (cluster?: Cluster) => string;
 
 declare const getCustomNaNoId: () => string;
-declare const safeParseJSON: (str: string) => any;
+declare const safeParseJSON: <T = any>(str: string | null | undefined, defaultValue?: T) => T;
 declare const isBeforeByUnix: (unix: number) => boolean;
 declare const delay: (ms: number) => Promise<unknown>;
 declare function retry<T>(fn: () => Promise<T>, options: {
@@ -2101,4 +2106,4 @@ declare const getAvailableClaimAmountForSignature: ({ contractAddress, chainId,
     }[];
 }) => Promise<string | 0>;
 
-export { AirdropSigIdentityTypeEnum, ApiClient, type ApiClientOptions, type ApiRequestOptions, CONST, ChainConfig, type ChainId, ChainType, ETokenType, ErrorCode, AirdropService$2 as EvmAirdropService, EvmAirdropVersionEnum, type EvmContractClientOption, SignatureAirdropService$1 as EvmSignatureAirdropService, type FetchTokenMetadataOptions, type FetchTokenVersionOptions, type IAirdropClaim, type IAirdropClaimData, type IAirdropData, type IAirdropOptions, type IAirdropService, type IAirdropSignatureClaim, type IAirdropSignatureData, type IAirdropSignatureIdentity, type IClaimSignature, type IContractConfig, type IProject, type IProjectExtra, type IWalletClient, type Identity, AirdropService$1 as SolanaAirdropService, SignatureAirdropService as SolanaSignatureAirdropService, SplTokenVersion, type SupportedChainType, SupportedChains, type ThemeConfig, AirdropService as TonAirdropService, TonAirdropVersionEnum, TonWalletService, ZERO_ADDRESS, apiClient, batchCheckClaimedForSignature, bindWallet, checkEligibility, checkGetSignatures, cleanUrlParams, clusterApiUrl, connectGoogleApi, connectTwitter, delay, disconnectRecipient, fetchTokenVersion, flipAddressType, getAirdropContractConfig, getAirdropPro, getAirdropProject, getAirdropProjectId, getAirdropQuery, getAvailableClaimAmountForSignature, getChainById, getChainConfig, getChainRpc, getCustomNaNoId, getJettonInfo, getOrCreateAssociatedTokenAccount, getTonProjectIdByAddress, hexStrToU8Array, isBeforeByUnix, isGreaterThan, isMobile, mevmDevNet, retry, safeParseJSON, safePlus, signBrBTestnet, solanaDevNet, solanaMainNet, tonMainNet, tonTestNet };
+export { AirdropSigIdentityTypeEnum, ApiClient, type ApiClientOptions, type ApiRequestOptions, CONST, ChainConfig, type ChainId, ChainType, ETokenType, ErrorCode, AirdropService$2 as EvmAirdropService, EvmAirdropVersionEnum, type EvmContractClientOption, SignatureAirdropService$1 as EvmSignatureAirdropService, type FetchTokenMetadataOptions, type FetchTokenVersionOptions, type IAirdropClaim, type IAirdropClaimData, type IAirdropData, type IAirdropOptions, type IAirdropService, type IAirdropSignatureClaim, type IAirdropSignatureData, type IAirdropSignatureIdentity, type IClaimSignature, type IContractConfig, type IExtraData, type IProject, type IProjectExtra, type IWalletClient, type Identity, AirdropService$1 as SolanaAirdropService, SignatureAirdropService as SolanaSignatureAirdropService, SplTokenVersion, type SupportedChainType, SupportedChains, type ThemeConfig, AirdropService as TonAirdropService, TonAirdropVersionEnum, TonWalletService, ZERO_ADDRESS, apiClient, batchCheckClaimedForSignature, bindWallet, checkEligibility, checkGetSignatures, cleanUrlParams, clusterApiUrl, connectGoogleApi, connectTwitter, delay, disconnectRecipient, fetchTokenVersion, flipAddressType, getAirdropContractConfig, getAirdropPro, getAirdropProject, getAirdropProjectId, getAirdropQuery, getAvailableClaimAmountForSignature, getChainById, getChainConfig, getChainRpc, getCustomNaNoId, getJettonInfo, getOrCreateAssociatedTokenAccount, getTonProjectIdByAddress, hexStrToU8Array, isBeforeByUnix, isGreaterThan, isMobile, mevmDevNet, retry, safeParseJSON, safePlus, signBrBTestnet, solanaDevNet, solanaMainNet, tonMainNet, tonTestNet };

package/dist/index.js

@@ -277,8 +277,8 @@ var ChainConfig = {
     rpcUrl: "https://zetachain-mainnet.g.alchemy.com/v2/1tmk0FrhwTJHXh0XIyae7_SXw1lDCjgs"
   },
   [import_chains.arbitrum.id]: {
-    contractAddress: "0x759ac3CA33FeeAfB8C41aEbC8687A7Bd849Fc87a",
-    rpcUrl: import_chains.arbitrum.rpcUrls.default.http[0]
+    contractAddress: "0xeD09c23677D02f4f486E55f0f081cfc114EEa53b",
+    rpcUrl: "https://arb-mainnet.g.alchemy.com/v2/udrqNPSB6i5n5L6QSM31Ng72h_hFOrVT"
   },
   [import_chains.berachainTestnet.id]: {
     contractAddress: "",
@@ -3899,11 +3899,16 @@ var getCustomNaNoId = () => {
   const nanoid = (0, import_nanoid.customAlphabet)("1234567890abcdefghijklmnopqrstuvwxyz", 10);
   return nanoid();
 };
-var safeParseJSON = (str) => {
+var safeParseJSON = (str, defaultValue = {}) => {
+  if (!str || typeof str !== "string") {
+    return defaultValue;
+  }
   try {
-    return JSON.parse(str);
+    const parsed = JSON.parse(str);
+    return parsed !== null && parsed !== void 0 ? parsed : defaultValue;
   } catch (error) {
-    return {};
+    console.warn("Failed to parse JSON:", error);
+    return defaultValue;
   }
 };
 var isBeforeByUnix = (unix) => {
@@ -3971,7 +3976,7 @@ var ApiClient = class _ApiClient {
     }
     const res = await fetch(finalUrl, init);
     const [status, resData] = await Promise.all([res.status, res.json()]);
-    if (status < 200 && status >= 300 || resData?.success !== true) {
+    if (status < 200 || status >= 300 || resData?.success !== true) {
       return Promise.reject(resData);
     }
     return resData.data;
@@ -4150,22 +4155,27 @@ var AirdropService = class {
     return this.airdropV3FeeClient.getFeelessThreshold();
   }
   async getClaimFee(address, amount) {
-    const feeCollector = await this.feeCollectors(this.options.contractAddress);
-    if (!feeCollector || feeCollector === ZERO_ADDRESS) {
-      return void 0;
-    }
-    const feeClient = this.getFeeClient(feeCollector);
-    const fee = await feeClient.getFee(address, amount);
-    const version = await this.getVersion();
-    if (version === "0.3.0" /* V3 */) {
-      const threshold = await this.getFeelessThreshold();
-      if (isGreaterThan(Number(amount), Number(threshold))) {
-        return fee;
-      } else {
+    try {
+      const feeCollector = await this.feeCollectors(this.options.contractAddress);
+      if (!feeCollector || feeCollector === ZERO_ADDRESS) {
         return void 0;
       }
+      const feeClient = this.getFeeClient(feeCollector);
+      const fee = await feeClient.getFee(address, amount);
+      const version = await this.getVersion();
+      if (version === "0.3.0" /* V3 */) {
+        const threshold = await this.getFeelessThreshold();
+        if (isGreaterThan(Number(amount), Number(threshold))) {
+          return fee;
+        } else {
+          return void 0;
+        }
+      }
+      return fee;
+    } catch (error) {
+      console.error("Failed to get claim fee:", error);
+      throw new Error(`Failed to calculate claim fee: ${error instanceof Error ? error.message : "Unknown error"}`);
     }
-    return fee;
   }
   async getKycThreshold() {
     const kycClient = await this.getKycClient();
@@ -10480,7 +10490,9 @@ var createApiClient = (baseURL) => {
 var getAirdropProject = async (projectId, baseURL) => {
   const client = createApiClient(baseURL);
   const res = await client.get(`/airdrop-open/projects/${projectId}`);
-  if (!res) return res;
+  if (!res) {
+    throw new Error(`Project not found: ${projectId}`);
+  }
   const projectConfig = res?.themeConf;
   const blockCountries = safeParseJSON(projectConfig?.blockCountries);
   return {