@sign-global/tokentable 0.0.1

package/src/airdrop/types/index.ts

@@ -0,0 +1,128 @@
+import { TonConnectUI } from '@tonconnect/ui-react';
+import { AirdropService as TonAirdropService } from '../core/ton/AirdropService';
+import { AirdropService as EvmAirdropService } from '../core/evm/AirdropService';
+import { TonClient } from '@ton/ton';
+import { ChainConfig } from '../constants';
+import { WalletClient as ViemWalletClient } from 'viem';
+
+export type ChainId = keyof typeof ChainConfig;
+
+export interface EvmContractClientOption {
+  chainId: ChainId;
+  walletClient?: ViemWalletClient;
+  contractAddress: string;
+  abi?: any;
+}
+
+export enum ChainType {
+  Evm = 'evm',
+  Ton = 'ton'
+}
+
+export interface IProject {
+  id: string;
+  name: string;
+  chainId: string;
+  chainType: ChainType;
+  tokenAddress: string;
+  tokenType: string;
+  startTime: number;
+  endTime: number;
+  contractAddress: string;
+  recipientType: string;
+  merkleRoot: string;
+  ownerAddress: string;
+  blockCountries: Record<string, string>;
+  themeConf: Record<string, any>;
+  version: string;
+  extra?: {
+    kyc: boolean;
+    tag: string;
+  };
+}
+
+export type IAirdropClaim = {
+  index: number;
+  recipient: string;
+  proof: string[];
+  amount: string;
+  unlockingAt: number;
+  group: string;
+  data: string;
+  leaf: string;
+  claimed?: boolean;
+
+  claimId?: string;
+
+  // ton
+  claimable?: boolean;
+  proofHash: string;
+  ownerAddress: string;
+  proofBoc: string;
+  expiryTimestamp: number;
+  expired?: boolean;
+  project: IProject;
+};
+
+export interface IAirdropData {
+  claims: IAirdropClaim[];
+}
+
+export enum TonAirdropVersionEnum {
+  V1 = '1.0.0',
+  V2 = '2.0.0',
+  LiteV1 = '11.0.0'
+}
+
+export enum EvmAirdropVersionEnum {
+  V0 = '0.0.2', // 兼容btc减半 airdrop
+  V3 = '0.3.0', // zeta 收费
+  V4 = '0.4.0' // zeta kyc、kyc threshold
+}
+
+export type IWalletClient = TonConnectUI | ViemWalletClient;
+
+export type IAirdropService = TonAirdropService | EvmAirdropService;
+
+export type BaseAirdropOptions = {
+  endpoint?: string;
+  projectId?: string;
+};
+
+type BaseTonConfig = {
+  endpoint?: string;
+  tonClient?: TonClient;
+};
+
+// 使用 projectId 的配置
+type TonProjectIdConfig = BaseTonConfig & {
+  projectId: string;
+  slug?: never; // 禁用 slug
+};
+
+// 使用 slug 的配置
+type TonSlugConfig = BaseTonConfig & {
+  slug: string;
+  projectId?: never; // 禁用 projectId
+};
+
+export type TonAirdropOptions = TonProjectIdConfig | TonSlugConfig;
+
+export interface EvmAirdropOptions extends BaseAirdropOptions {
+  projectId: string;
+}
+
+export interface TonContractWrapperOptions {
+  chainId: ChainId;
+  contractAddress: string;
+  walletClient?: TonConnectUI;
+  tonClient?: TonClient;
+}
+
+export interface EvmContractWrapperOptions {
+  chainId: ChainId;
+  contractAddress: string;
+  walletClient?: ViemWalletClient;
+}
+
+export type ContractWrapperOptions = TonContractWrapperOptions | EvmContractWrapperOptions;

package/src/index.ts

@@ -0,0 +1 @@
+export { EvmAirdropClient, TonAirdropClient } from './airdrop';

package/src/utils/api-client.ts

@@ -0,0 +1,68 @@
+export type ApiClientOptions = {
+  baseURL?: string;
+};
+
+export type ApiRequestOptions = {
+  params?: Record<string, string | number>;
+  skipHandleError?: boolean;
+};
+
+type ApiResponse = {
+  message: string;
+  statusCode: number;
+  data: unknown;
+  success: boolean;
+};
+
+export class ApiClient {
+  constructor(private options?: ApiClientOptions) {}
+
+  extend(options: ApiClientOptions): ApiClient {
+    return new ApiClient({
+      ...this.options,
+      ...options
+    });
+  }
+
+  async get<TRes>(url: string, options?: ApiRequestOptions): Promise<TRes> {
+    return this.request('GET', url, null, options) as TRes;
+  }
+
+  async post<TRes, TReq = unknown>(url: string, data?: TReq, options?: ApiRequestOptions): Promise<TRes> {
+    return this.request('POST', url, data, options) as TRes;
+  }
+
+  async put<TRes, TReq = unknown>(url: string, data?: TReq, options?: ApiRequestOptions): Promise<TRes> {
+    return this.request('PUT', url, data, options) as TRes;
+  }
+
+  async delete<TRes>(url: string, options?: ApiRequestOptions): Promise<TRes> {
+    return this.request('DELETE', url, null, options) as TRes;
+  }
+
+  private async request(
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE',
+    url: string,
+    data: unknown,
+    options?: ApiRequestOptions
+  ): Promise<unknown> {
+    const finalUrl = (this.options?.baseURL || '') + url;
+
+    const init: RequestInit = { method };
+    if (data instanceof FormData) {
+      init.body = data;
+    } else {
+      init.headers = { 'content-type': 'application/json' };
+      init.body = data ? JSON.stringify(data) : void 0;
+    }
+
+    const res = await fetch(finalUrl, init);
+    const [status, resData]: [number, ApiResponse] = await Promise.all([res.status, res.json() as any]);
+    if ((status < 200 && status >= 300) || resData?.success !== true) {
+      return Promise.reject(resData);
+    }
+    return resData.data;
+  }
+}
+
+export const apiClient = new ApiClient({ baseURL: 'https://claim.tokentable.xyz/api' });

package/src/utils/index.ts

@@ -0,0 +1,3 @@
+export * from './web3';
+export * from './utils';
+export * from './api-client';

package/src/utils/utils.ts

@@ -0,0 +1,30 @@
+import dayjs from 'dayjs';
+
+export const safeParseJSON = (str: string): any => {
+  try {
+    return JSON.parse(str);
+  } catch (error) {
+    return {};
+  }
+};
+
+export const isBeforeByUnix = (unix: number) => {
+  return dayjs(new Date()).isBefore(dayjs.unix(unix), 'millisecond');
+};
+
+export const delay = (ms: number): Promise<unknown> => new Promise((res) => setTimeout(res, ms));
+
+export async function retry<T>(fn: () => Promise<T>, options: { retries: number; delay: number }): Promise<T> {
+  let lastError: Error | undefined;
+  for (let i = 0; i < options.retries; i++) {
+    try {
+      return await fn();
+    } catch (e) {
+      if (e instanceof Error) {
+        lastError = e;
+      }
+      await new Promise((resolve) => setTimeout(resolve, options.delay));
+    }
+  }
+  throw lastError;
+}

package/src/utils/web3.ts

@@ -0,0 +1,8 @@
+import TonWeb from 'tonweb';
+
+export function flipAddressType(address: string) {
+  if (!address) return '';
+  return address.includes(':')
+    ? new TonWeb.utils.Address(address).toString(true, true, true)
+    : new TonWeb.utils.Address(address).toString(false, false, true);
+}

package/tsconfig.json

@@ -0,0 +1,29 @@
+{
+  "compilerOptions": {
+    // Enable latest features
+    "lib": ["ESNext"],
+    "target": "ESNext",
+    "module": "ESNext",
+    
+
+    "outDir": "./dist",
+    "declaration": true,       
+    "sourceMap": true, 
+
+    // Bundler mode
+    "moduleResolution": "node",
+   "esModuleInterop": true,
+    "resolveJsonModule": true,
+
+    // Best practices
+    "strict": true,
+    "skipLibCheck": true,
+    
+    "removeComments": false, 
+    "allowJs": false,
+    "isolatedModules": true
+
+  },
+  "include": ["src/**/*", "src/utils"],
+  "exclude": ["node_modules", "dist", "**/*.test.ts"]
+}