@weblock-wallet/sdk 0.1.25

package/dist/index.d.cts

@@ -0,0 +1,491 @@
+declare enum SDKErrorCode {
+    NOT_INITIALIZED = "NOT_INITIALIZED",
+    INVALID_CONFIG = "INVALID_CONFIG",
+    AUTH_REQUIRED = "AUTH_REQUIRED",
+    REQUEST_FAILED = "REQUEST_FAILED",
+    AUTH_FAILED = "AUTH_FAILED",
+    AUTH_NO_USER = "AUTH_NO_USER",
+    AUTH_NO_EMAIL = "AUTH_NO_EMAIL",
+    AUTH_PROVIDER_ERROR = "AUTH_PROVIDER_ERROR",
+    AUTH_SIGNOUT_FAILED = "AUTH_SIGNOUT_FAILED",
+    WALLET_NOT_FOUND = "WALLET_NOT_FOUND",
+    WALLET_ALREADY_EXISTS = "WALLET_ALREADY_EXISTS",
+    WALLET_CREATION_FAILED = "WALLET_CREATION_FAILED",
+    INVALID_PASSWORD = "INVALID_PASSWORD",
+    ASSET_NOT_FOUND = "ASSET_NOT_FOUND",
+    INSUFFICIENT_BALANCE = "INSUFFICIENT_BALANCE",
+    TRANSFER_FAILED = "TRANSFER_FAILED",
+    NETWORK_ERROR = "NETWORK_ERROR",
+    INVALID_RESPONSE = "INVALID_RESPONSE",
+    TIMEOUT = "TIMEOUT",
+    UNKNOWN_ERROR = "UNKNOWN_ERROR",
+    INVALID_PARAMS = "INVALID_PARAMS",
+    WALLET_CREATION_VERIFICATION_FAILED = "WALLET_CREATION_VERIFICATION_FAILED",
+    WALLET_RECOVERY_FAILED = "WALLET_RECOVERY_FAILED",
+    INVALID_NETWORK = "INVALID_NETWORK",
+    WALLET_RETRIEVAL_FAILED = "WALLET_RETRIEVAL_FAILED",
+    NOT_LOGGED_IN = "NOT_LOGGED_IN",
+    NETWORK_SWITCH_FAILED = "NETWORK_SWITCH_FAILED",
+    TRANSACTION_FAILED = "TRANSACTION_FAILED"
+}
+declare class SDKError extends Error {
+    readonly code: SDKErrorCode;
+    readonly details?: unknown | undefined;
+    constructor(message: string, code: SDKErrorCode, details?: unknown | undefined);
+}
+
+/**
+ * SDK 초기화 옵션
+ */
+interface SDKOptions {
+    /** SDK 환경 설정 (local, dev, stage, prod) */
+    environment: 'local' | 'dev' | 'stage' | 'prod';
+    /** SDK API 키 */
+    apiKey: string;
+    /** 허용 호스트 */
+    orgHost: string;
+}
+/**
+ * 토큰 타입
+ */
+declare enum TokenType {
+    /** ERC20 토큰 */
+    ERC20 = "ERC20",
+    /** 보안토큰 */
+    SECURITY = "SECURITY",
+    /** 네이티브 토큰 */
+    NATIVE = "NATIVE"
+}
+/**
+ * 트랜잭션 상태
+ */
+declare enum TransactionStatus {
+    /** 처리 중 */
+    PENDING = "PENDING",
+    /** 성공 */
+    SUCCESS = "SUCCESS",
+    /** 실패 */
+    FAILED = "FAILED"
+}
+/**
+ * 트랜잭션 타입
+ */
+declare enum TransactionType {
+    /** 송금 */
+    SEND = "SEND",
+    /** 수금 */
+    RECEIVE = "RECEIVE"
+}
+/**
+ * 로그인 상태
+ */
+declare enum SignInStatus {
+    /** 신규 사용자 */
+    NEW_USER = "NEW_USER",
+    /** 지갑 준비됨 */
+    WALLET_READY = "WALLET_READY",
+    /** 비밀번호 필요 */
+    NEEDS_PASSWORD = "NEEDS_PASSWORD"
+}
+/**
+ * 네트워크 정보
+ */
+interface NetworkInfo {
+    /** 네트워크 고유 식별자 */
+    id: string;
+    /** 네트워크 표시 이름 */
+    name: string;
+    /** 체인 ID */
+    chainId: number;
+    /** 네트워크 기본 토큰 심볼 */
+    symbol: string;
+    /** RPC 엔드포인트 */
+    rpcUrl: string;
+    /** 블록 익스플로러 URL */
+    explorerUrl: string;
+    /** 테스트넷 여부 */
+    isTestnet: boolean;
+    /** 네트워크 아이콘 URL */
+    icon?: string;
+    /** 네트워크 기본 토큰 소수점 자리수 */
+    decimals: number;
+}
+/**
+ * 토큰 잔액 정보
+ */
+interface TokenBalance {
+    /** 원본 값 (Wei) */
+    raw: string;
+    /** 변환된 값 */
+    formatted: string;
+    /** 소수점 자리수 */
+    decimals: number;
+    /** 토큰 심볼 */
+    symbol: string;
+}
+/**
+ * 토큰 정보
+ */
+interface TokenInfo {
+    /** 토큰 심볼 */
+    symbol: string;
+    /** 토큰 이름 */
+    name: string;
+    /** 컨트랙트 주소 */
+    address: string;
+    /** 토큰 잔액 */
+    balance: TokenBalance;
+    /** 토큰 소수점 자리수 */
+    decimals: number;
+    /** 토큰 총 발행량 */
+    totalSupply: TokenBalance;
+}
+/**
+ * NFT 컬렉션 정보 (TODO: ERC721 구현 시 확장)
+ */
+interface NFTCollection {
+    /** 컬렉션 이름 */
+    name: string;
+    /** 컨트랙트 주소 */
+    address: string;
+    /** 보유 중인 NFT 목록 */
+    tokens: Array<{
+        /** 토큰 ID */
+        tokenId: string;
+        /** NFT 이미지 URL */
+        image?: string;
+    }>;
+}
+/**
+ * 보안토큰 정보 (TODO: ERC3643 구현 시 확장)
+ */
+interface SecurityTokenInfo {
+    /** 토큰 심볼 */
+    symbol: string;
+    /** 토큰 이름 */
+    name: string;
+    /** 컨트랙트 주소 */
+    address: string;
+    /** 토큰 잔액 */
+    balance: string | null;
+    /** 토큰 소수점 자리수 */
+    decimals: number;
+    /** 토큰 총 발행량 */
+    totalSupply: string;
+    /** 컴플라이언스 정보 */
+    compliance: {
+        /** 검증 여부 */
+        isVerified: boolean;
+        /** 전송 가능 여부 */
+        canTransfer: boolean;
+    };
+}
+/**
+ * 트랜잭션 정보
+ */
+interface Transaction {
+    /** 트랜잭션 해시 */
+    hash: string;
+    /** 트랜잭션 타입 */
+    type: TransactionType;
+    /** 트랜잭션 상태 */
+    status: TransactionStatus;
+    /** 트랜잭션 타임스탬프 */
+    timestamp: number;
+    /** 거래 금액 */
+    value: string;
+    /** 토큰 심볼 */
+    symbol: string;
+}
+/**
+ * 지갑 정보
+ */
+interface WalletInfo {
+    /** 지갑 주소 */
+    address: string;
+    /** 네트워크 정보 */
+    network: {
+        /** 현재 선택된 네트워크 */
+        current: NetworkInfo | null;
+        /** 사용 가능한 네트워크 목록 */
+        available: NetworkInfo[];
+    };
+    /** 자산 정보 */
+    assets: {
+        /** 현재 네트워크의 ��본 토큰 정보 */
+        native: {
+            symbol: string;
+            balance: TokenBalance;
+            decimals: number;
+        };
+        /** ERC20 토큰 목록 */
+        tokens: TokenInfo[];
+        /** NFT 컬렉션 목록 */
+        nfts: NFTCollection[];
+        /** 보안토큰 목록 */
+        securities: SecurityTokenInfo[];
+    };
+    /** 최근 트랜잭션 */
+    latestTransaction?: Transaction;
+}
+/**
+ * 로그인 응답
+ */
+interface SignInResponse {
+    /** 로그인 상태 */
+    status: SignInStatus;
+    /** 사용자 이메일 */
+    email: string;
+    /** 프로필 이미지 URL */
+    photoURL: string | null;
+    /** 지갑 정보 (WALLET_READY 상태일 때만) */
+    wallet?: WalletInfo;
+}
+/**
+ * 지갑 생성/복구 응답
+ */
+interface WalletResponse {
+    /** 지갑 정보 */
+    wallet: WalletInfo;
+}
+/**
+ * 네트워크 변경 응답
+ */
+interface SwitchNetworkResponse {
+    network: NetworkInfo;
+    assets: WalletInfo['assets'];
+}
+/**
+ * 토큰 전송 요청
+ */
+interface TransferRequest {
+    /** 네트워크 ID */
+    networkId: string;
+    /** 토큰 컨트랙트 주소 */
+    tokenAddress: string;
+    /** 수신자 주소 */
+    to: string;
+    /** 전송 금액 */
+    amount: string;
+    /** 토큰 타입 */
+    type: 'NATIVE' | 'ERC20';
+    /** 토큰 심볼 */
+    symbol?: string;
+    /** 가스 제한 */
+    gasLimit?: string;
+    /** 가스 가격 */
+    gasPrice?: string;
+}
+/**
+ * 토큰 전송 응답
+ */
+interface TransferResponse {
+    transaction: Transaction;
+}
+/**
+ * 네트워크 등록 요청
+ */
+interface AddNetworkRequest {
+    /** 네트워크 이름 (예: "Ethereum Mainnet", "Polygon Mumbai") */
+    name: string;
+    /** RPC URL */
+    rpcUrl: string;
+    /** 체인 ID */
+    chainId: number;
+}
+interface TokenBalanceParams {
+    networkId: string;
+    tokenAddress: string;
+    walletAddress: string;
+}
+interface TokenApprovalParams {
+    networkId: string;
+    tokenAddress: string;
+    spender: string;
+    amount: string;
+}
+interface TokenAllowanceParams {
+    networkId: string;
+    tokenAddress: string;
+    owner: string;
+    spender: string;
+}
+interface TokenInfoParams {
+    networkId: string;
+    tokenAddress: string;
+}
+interface SendTransactionParams {
+    to: string;
+    value: string;
+    data?: string;
+    chainId: number;
+    gasLimit?: string;
+    gasPrice?: string;
+    nonce?: number;
+}
+interface TransactionReceipt {
+    transactionHash: string;
+    transactionIndex: string;
+    blockHash: string;
+    blockNumber: string;
+    from: string;
+    to: string;
+    cumulativeGasUsed: string;
+    gasUsed: string;
+    contractAddress: string | null;
+    logs: Array<Log>;
+    status: string;
+    logsBloom: string;
+    effectiveGasPrice?: string;
+}
+interface Log {
+    address: string;
+    topics: string[];
+    data: string;
+    blockNumber: string;
+    transactionHash: string;
+    transactionIndex: string;
+    blockHash: string;
+    logIndex: string;
+    removed: boolean;
+}
+interface TransactionStatusEvent {
+    hash: string;
+    status: TransactionStatus;
+    error?: string;
+    timestamp: number;
+}
+
+interface TokenMetadata {
+    address: string;
+    name: string;
+    symbol: string;
+    decimals: number;
+}
+
+declare class TokenAmount {
+    /**
+     * Wei 단위의 값을 사용자가 읽을 수 있는 형태로 변환
+     * @param value - Wei 단위의 값 (hex string 또는 decimal string)
+     * @param decimals - 토큰의 소수점 자리수
+     * @returns 변환된 문자열
+     */
+    static fromWei(value: string, decimals: number): string;
+    /**
+     * 사용자 입력값을 Wei 단위로 변환
+     * @param value - 사용자 입력값 (예: "1.5")
+     * @param decimals - 토큰의 소수점 자리수
+     * @returns Wei 단위의 값
+     */
+    static toWei(value: string, decimals: number): string;
+    /**
+     * 표시용 포맷으로 변환
+     * @param value - Wei 단위의 값
+     * @param decimals - 토큰의 소수점 자리수
+     * @param maxDecimals - 최대 표시할 소수점 자리수 (기본값: 4)
+     * @returns 포맷된 문자열
+     */
+    static format(value: string, decimals: number, maxDecimals?: number): string;
+    /**
+     * 값이 유효한지 검증
+     * @param value - 검증할 값
+     * @returns 유효성 여부
+     */
+    static isValid(value: string): boolean;
+}
+declare const DECIMALS: {
+    readonly ETH: 18;
+    readonly USDC: 6;
+    readonly USDT: 6;
+    readonly DAI: 18;
+};
+
+/**
+ * WeBlock Wallet SDK
+ * 논커스토디얼 웹3 지갑 SDK
+ */
+declare class WeBlockSDK {
+    private readonly core;
+    private readonly userModule;
+    private readonly walletModule;
+    private readonly assetModule;
+    private readonly networkModule;
+    private initialized;
+    constructor(options: SDKOptions);
+    private validateOptions;
+    private ensureInitialized;
+    isInitialized(): boolean;
+    readonly user: {
+        signIn: (provider: "google.com") => Promise<SignInResponse>;
+        createWallet: (password: string) => Promise<WalletResponse>;
+        retrieveWallet: (password: string) => Promise<WalletResponse>;
+        signOut: () => Promise<void>;
+    };
+    readonly wallet: {
+        getInfo: () => Promise<WalletInfo>;
+        onWalletUpdate: (callback: (wallet: WalletInfo) => void) => (() => void);
+        onTransactionUpdate: (callback: (tx: Transaction | undefined) => void) => (() => void);
+        getBalance: (address: string, chainId: number) => Promise<TokenBalance>;
+        getTransactionCount: (address: string, chainId: number) => Promise<number>;
+        getBlockNumber: (chainId: number) => Promise<number>;
+        sendRawTransaction: (signedTx: string, chainId: number) => Promise<string>;
+        getTransactionReceipt: (txHash: string, chainId: number) => Promise<any>;
+        getTransaction: (txHash: string, chainId: number) => Promise<any>;
+        estimateGas: (txParams: any, chainId: number) => Promise<number>;
+        getGasPrice: (chainId: number) => Promise<string>;
+        call: (txParams: any, blockParam: string | number, chainId: number) => Promise<string>;
+    };
+    readonly network: {
+        getAvailableNetworks: () => Promise<NetworkInfo[]>;
+        addNetwork: (request: AddNetworkRequest) => Promise<void>;
+        switchNetwork: (networkId: string) => Promise<void>;
+        getCurrentNetwork: () => Promise<NetworkInfo | null>;
+    };
+    readonly asset: {
+        transfer: (params: TransferRequest) => Promise<TransferResponse>;
+        addToken: (params: {
+            type: "ERC20" | "SECURITY";
+            networkId: string;
+            address: string;
+            symbol?: string;
+            decimals?: number;
+            name?: string;
+        }) => Promise<void>;
+        addNFTCollection: (params: {
+            networkId: string;
+            address: string;
+            name?: string;
+        }) => Promise<void>;
+        getTokenBalance: (params: {
+            networkId: string;
+            tokenAddress: string;
+            walletAddress: string;
+        }) => Promise<string>;
+        approveToken: (params: {
+            networkId: string;
+            tokenAddress: string;
+            spender: string;
+            amount: string;
+        }) => Promise<string>;
+        getAllowance: (params: {
+            networkId: string;
+            tokenAddress: string;
+            owner: string;
+            spender: string;
+        }) => Promise<string>;
+        on: (event: string, listener: (...args: any[]) => void) => void;
+        off: (event: string, listener: (...args: any[]) => void) => void;
+        getTokenInfo: (params: TokenInfoParams) => Promise<TokenMetadata>;
+        registerToken: (params: {
+            networkId: string;
+            tokenAddress: string;
+        }) => Promise<void>;
+        getTokenFullInfo: (params: {
+            networkId: string;
+            tokenAddress: string;
+            walletAddress: string;
+        }) => Promise<TokenInfo>;
+    };
+}
+
+export { type AddNetworkRequest, DECIMALS, type NFTCollection, type NetworkInfo, SDKError, SDKErrorCode, type SDKOptions, type SecurityTokenInfo, type SendTransactionParams, type SignInResponse, SignInStatus, type SwitchNetworkResponse, type TokenAllowanceParams, TokenAmount, type TokenApprovalParams, type TokenBalance, type TokenBalanceParams, type TokenInfo, type TokenInfoParams, type TokenMetadata, TokenType, type Transaction, type TransactionReceipt, TransactionStatus, type TransactionStatusEvent, TransactionType, type TransferRequest, type TransferResponse, type WalletInfo, type WalletResponse, WeBlockSDK, WeBlockSDK as default };