@sequence0/sdk 1.1.2 → 2.0.0

package/dist/core/types.d.ts

@@ -10,7 +10,7 @@
  * expects back a 0x-prefixed hex string of the 65-byte compact signature.
  */
 export type OwnerSigner = (messageHash: Uint8Array) => Promise<string>;
-export type Chain = 'ethereum' | 'polygon' | 'bsc' | 'avalanche' | 'fantom' | 'gnosis' | 'celo' | 'cronos' | 'moonbeam' | 'moonriver' | 'harmony' | 'kava' | 'canto' | 'aurora' | 'klaytn' | 'okc' | 'fuse' | 'evmos' | 'core' | 'flare' | 'iotex' | 'rootstock' | 'telos' | 'thundercore' | 'arbitrum' | 'optimism' | 'base' | 'zksync' | 'scroll' | 'linea' | 'mantle' | 'blast' | 'mode' | 'manta' | 'polygon-zkevm' | 'metis' | 'zora' | 'sei' | 'boba' | 'taiko' | 'opbnb' | 'fraxtal' | 'worldchain' | 'lisk' | 'redstone' | 'cyber' | 'mint' | 'bob' | 'xai' | 'morph' | 'astar-zkevm' | 'bitcoin' | 'solana' | 'cosmos' | 'near' | 'sui' | 'aptos' | 'polkadot' | 'cardano' | 'tron' | 'dogecoin' | 'litecoin' | 'stellar' | 'ton' | 'algorand' | 'tezos' | 'ripple';
+export type Chain = 'ethereum' | 'polygon' | 'bsc' | 'avalanche' | 'fantom' | 'gnosis' | 'celo' | 'cronos' | 'moonbeam' | 'moonriver' | 'harmony' | 'kava' | 'canto' | 'aurora' | 'klaytn' | 'okc' | 'fuse' | 'evmos' | 'core' | 'flare' | 'iotex' | 'rootstock' | 'telos' | 'thundercore' | 'arbitrum' | 'optimism' | 'base' | 'zksync' | 'scroll' | 'linea' | 'mantle' | 'blast' | 'mode' | 'manta' | 'polygon-zkevm' | 'metis' | 'zora' | 'sei' | 'boba' | 'taiko' | 'opbnb' | 'fraxtal' | 'worldchain' | 'lisk' | 'redstone' | 'cyber' | 'mint' | 'bob' | 'xai' | 'morph' | 'astar-zkevm' | 'berachain' | 'sonic' | 'abstract' | 'ink' | 'unichain' | 'soneium' | 'gravity' | 'zklink-nova' | 'bitcoin' | 'solana' | 'cosmos' | 'near' | 'sui' | 'aptos' | 'polkadot' | 'cardano' | 'tron' | 'dogecoin' | 'litecoin' | 'stellar' | 'ton' | 'algorand' | 'tezos' | 'ripple' | 'bitcoincash' | 'bitcoinsv' | 'multiversx' | 'kaspa' | 'hedera' | 'icp';
 export interface NetworkConfig {
     /** Network: 'testnet' or 'mainnet' */
     network: 'testnet' | 'mainnet';
@@ -54,6 +54,17 @@ export interface NetworkConfig {
      * Does not affect explicitly-provided `agentUrl`.
      */
     useHttps?: boolean;
+    /**
+     * Optional: delegate's private key for signing as a delegated authority.
+     * When provided along with `delegationId`, signing requests use
+     * `delegation_id` and `delegate_signature` instead of `owner_signature`.
+     */
+    delegatePrivateKey?: string;
+    /**
+     * Optional: delegation grant ID for delegate signing.
+     * Must be provided together with `delegatePrivateKey`.
+     */
+    delegationId?: string;
 }
 /** Agent node info from on-chain registry */
 export interface AgentInfo {
@@ -204,5 +215,165 @@ export interface ChainAdapter {
     getBalance(address: string): Promise<string>;
     /** Get chain-specific RPC URL */
     getRpcUrl(): string;
+    /** Extract the signing payload from buildTransaction() output. If not implemented, the full output is used. */
+    getSigningPayload?(unsignedTx: string): string;
+}
+export interface CosmosTransaction {
+    /** Recipient bech32 address */
+    to: string;
+    /** Amount in base denom (e.g. uatom) */
+    amount: string;
+    /** Token denom (default: 'uatom') */
+    denom?: string;
+    /** Gas limit (default: '200000') */
+    gas?: string;
+    /** Cosmos chain ID (e.g. 'cosmoshub-4') */
+    chainId?: string;
+    /** TX memo */
+    memo?: string;
+}
+export interface TronTransaction {
+    /** Recipient T-address */
+    to: string;
+    /** Amount in SUN (1 TRX = 1e6 SUN) */
+    amount: number;
+}
+export interface RippleTransaction {
+    /** Recipient r-address */
+    to: string;
+    /** Amount in drops (1 XRP = 1e6 drops) */
+    amount: string;
+    /** Destination tag (for exchanges) */
+    tag?: number;
+    /** Fee in drops */
+    fee?: string;
+}
+export interface NearTransaction {
+    /** Receiver account ID (e.g. 'bob.near') */
+    to: string;
+    /** Amount in yoctoNEAR (1 NEAR = 1e24 yoctoNEAR) */
+    amount: string;
+}
+export interface SuiTransaction {
+    /** Recipient address (0x...) */
+    to: string;
+    /** Amount in MIST (1 SUI = 1e9 MIST) */
+    amount: string;
+}
+export interface AptosTransaction {
+    /** Recipient address (0x...) */
+    to: string;
+    /** Amount in Octas (1 APT = 1e8 Octas) */
+    amount: string;
+}
+export interface StellarTransaction {
+    /** Recipient G-address */
+    to: string;
+    /** Amount in stroops (1 XLM = 1e7 stroops) */
+    amount: string;
+    /** TX memo */
+    memo?: string;
+}
+export interface TonTransaction {
+    /** Recipient EQ.../UQ... address */
+    to: string;
+    /** Amount in nanotons (1 TON = 1e9 nanotons) */
+    amount: string;
+    /** Optional comment/payload */
+    payload?: string;
+}
+export interface AlgorandTransaction {
+    /** Recipient base32 address */
+    to: string;
+    /** Amount in microAlgos (1 ALGO = 1e6 microAlgos) */
+    amount: number;
+    /** Optional note */
+    note?: string;
+}
+export interface TezosTransaction {
+    /** Recipient tz/KT address */
+    to: string;
+    /** Amount in mutez (1 XTZ = 1e6 mutez) */
+    amount: string;
+}
+export interface CardanoTransaction {
+    /** Recipient addr1... address */
+    to: string;
+    /** Amount in lovelace (1 ADA = 1e6 lovelace) */
+    amount: string;
+}
+export interface PolkadotTransaction {
+    /** Recipient SS58 address */
+    to: string;
+    /** Amount in planck (1 DOT = 1e10 planck) */
+    amount: string;
+}
+export interface DogeTransaction {
+    /** Recipient address */
+    to: string;
+    /** Amount in koinu (1 DOGE = 1e8 koinu) */
+    amount: number;
+    /** Fee rate in koinu/byte */
+    feeRate?: number;
+}
+export interface LtcTransaction {
+    /** Recipient address */
+    to: string;
+    /** Amount in litoshi (1 LTC = 1e8 litoshi) */
+    amount: number;
+    /** Fee rate in litoshi/byte */
+    feeRate?: number;
+}
+export interface BchTransaction {
+    /** Recipient address */
+    to: string;
+    /** Amount in satoshis (1 BCH = 1e8 satoshis) */
+    amount: number;
+    /** Fee rate in sat/byte */
+    feeRate?: number;
+}
+export interface BsvTransaction {
+    /** Recipient address */
+    to: string;
+    /** Amount in satoshis (1 BSV = 1e8 satoshis) */
+    amount: number;
+    /** Fee rate in sat/byte */
+    feeRate?: number;
+}
+export interface MultiversXTransaction {
+    /** Recipient erd1... bech32 address */
+    to: string;
+    /** Amount in atomic EGLD (1 EGLD = 1e18) */
+    amount: string;
+    /** Optional TX data */
+    data?: string;
+    /** Gas limit */
+    gasLimit?: number;
+}
+export interface KaspaTransaction {
+    /** Recipient kaspa:... address */
+    to: string;
+    /** Amount in sompi (1 KAS = 1e8 sompi) */
+    amount: number;
+    /** Fee rate in sompi/gram */
+    feeRate?: number;
+}
+export interface HederaTransaction {
+    /** Recipient 0.0.XXXXX account ID */
+    to: string;
+    /** Amount in tinybars (1 HBAR = 1e8 tinybars) */
+    amount: string;
+    /** TX memo */
+    memo?: string;
+}
+export interface IcpTransaction {
+    /** Recipient principal or account ID */
+    to: string;
+    /** Amount in e8s (1 ICP = 1e8 e8s) */
+    amount: string;
+    /** Optional memo */
+    memo?: bigint;
+    /** Fee in e8s */
+    fee?: string;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

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

package/dist/core/universal-account.d.ts

@@ -0,0 +1,438 @@
+/**
+ * K7: Universal Account — One Wallet, All Chains
+ *
+ * A single account identity that works across all 81 supported chains.
+ * Threshold keys (secp256k1 + ed25519) are generated once, and chain-
+ * specific addresses are derived deterministically. Send any token on
+ * any chain from one unified account, with automatic routing to the
+ * optimal source chain.
+ *
+ * @example
+ * ```typescript
+ * import { UniversalAccountClient } from '@sequence0/sdk';
+ *
+ * const ua = new UniversalAccountClient('http://agent:8080');
+ *
+ * // Create a universal account
+ * const account = await ua.createAccount({
+ *   ownerSignature: '0x...',
+ *   timestamp: Date.now(),
+ * });
+ *
+ * // View all chain addresses
+ * const addresses = await ua.getChainAddresses(account.accountId);
+ * console.log('Ethereum:', addresses.ethereum.address);
+ * console.log('Solana:', addresses.solana.address);
+ * console.log('Bitcoin:', addresses.bitcoin.address);
+ *
+ * // Get unified balance across all chains
+ * const balance = await ua.getUnifiedBalance(account.accountId);
+ * for (const chain of balance.chains) {
+ *   console.log(`${chain.chain}: ${chain.nativeBalance} ${chain.nativeSymbol}`);
+ * }
+ *
+ * // Send — automatic routing picks the best source chain
+ * const result = await ua.send({
+ *   accountId: account.accountId,
+ *   to: '0xRecipient...',
+ *   amount: '1.0',
+ *   token: 'ETH',
+ *   ownerSignature: '0x...',
+ *   timestamp: Date.now(),
+ * });
+ * console.log('Tx:', result.txHash);
+ * ```
+ */
+/**
+ * Address information for a single chain within a universal account.
+ */
+export interface ChainAddressInfo {
+    /** Chain name (e.g., 'ethereum', 'bitcoin', 'solana') */
+    chain: string;
+    /** Derived address on this chain */
+    address: string;
+    /** Curve used for key derivation on this chain */
+    curveType: 'secp256k1' | 'ed25519';
+    /** Whether this chain address is currently active */
+    isActive: boolean;
+}
+/**
+ * Full information about a universal account, including its
+ * threshold parameters, group keys, and all derived chain addresses.
+ */
+export interface UniversalAccountInfo {
+    /** Unique account identifier */
+    accountId: string;
+    /** On-chain owner address (Ethereum address that controls this account) */
+    ownerAddress: string;
+    /** Hex-encoded secp256k1 group public key */
+    secp256k1GroupKey: string;
+    /** Hex-encoded ed25519 group public key */
+    ed25519GroupKey: string;
+    /** Signing threshold (number of agents required to sign) */
+    threshold: number;
+    /** Total committee size */
+    committeeSize: number;
+    /** Map of chain name to chain address info */
+    chainAddresses: Record<string, ChainAddressInfo>;
+    /** Unix timestamp of account creation */
+    createdAt: number;
+    /** Whether the account is currently active */
+    isActive: boolean;
+}
+/**
+ * Balance information for a single token on a chain.
+ */
+export interface TokenBalance {
+    /** Token symbol (e.g., 'USDC', 'WETH') */
+    symbol: string;
+    /** Token contract address (undefined for native tokens) */
+    contractAddress?: string;
+    /** Token balance as a decimal string */
+    balance: string;
+    /** Token decimals */
+    decimals: number;
+}
+/**
+ * Balance information for a single chain, including native token
+ * and any tracked ERC-20 / SPL / equivalent token balances.
+ */
+export interface ChainBalance {
+    /** Chain name */
+    chain: string;
+    /** Account address on this chain */
+    address: string;
+    /** Native token balance as a decimal string */
+    nativeBalance: string;
+    /** Native token symbol (e.g., 'ETH', 'SOL', 'BTC') */
+    nativeSymbol: string;
+    /** Token balances on this chain */
+    tokens: TokenBalance[];
+    /** Unix timestamp of last balance update */
+    lastUpdated: number;
+}
+/**
+ * Aggregated balance view across all chains for a universal account.
+ */
+export interface UnifiedBalance {
+    /** Account ID this balance belongs to */
+    accountId: string;
+    /** Per-chain balance breakdown */
+    chains: ChainBalance[];
+    /** Total number of chains with balances */
+    totalChains: number;
+    /** Unix timestamp of last aggregation */
+    lastAggregated: number;
+}
+/**
+ * Options for sending tokens from a universal account.
+ * The agent network automatically routes to the optimal source chain
+ * based on available balances, fees, and latency.
+ */
+export interface UniversalSendOptions {
+    /** Account ID to send from */
+    accountId: string;
+    /** Destination address or account ID */
+    to: string;
+    /** Amount to send as a decimal string */
+    amount: string;
+    /** Token symbol (e.g., 'ETH', 'USDC', 'SOL', 'BTC') */
+    token: string;
+    /** Optional preferred source chain (overrides automatic routing) */
+    preferredChain?: string;
+    /** Owner signature authorizing this send */
+    ownerSignature: string;
+    /** Unix timestamp of the signature */
+    timestamp: number;
+}
+/**
+ * The routing decision made by the agent network for a send operation.
+ * Describes which chain and address will be used as source and destination.
+ */
+export interface RoutingDecision {
+    /** Source chain selected for this send */
+    sourceChain: string;
+    /** Source address on the selected chain */
+    sourceAddress: string;
+    /** Destination chain */
+    destinationChain: string;
+    /** Destination address */
+    destinationAddress: string;
+    /** Amount being sent */
+    amount: string;
+    /** Token being sent */
+    token: string;
+    /** Estimated fee in the source chain's native token */
+    estimatedFee: string;
+    /** Human-readable reason for this routing choice */
+    reason: string;
+}
+/**
+ * Result of a universal send operation.
+ *
+ * - `pending`      — request received, queued for processing
+ * - `routing`      — agent is selecting the optimal source chain
+ * - `signing`      — threshold signing in progress
+ * - `broadcasting` — signed transaction is being broadcast to the chain
+ * - `confirmed`    — transaction confirmed on-chain
+ * - `failed`       — send failed (check routing.reason for details)
+ */
+export type SendStatus = 'pending' | 'routing' | 'signing' | 'broadcasting' | 'confirmed' | 'failed';
+export interface SendResult {
+    /** Unique request identifier for polling status */
+    requestId: string;
+    /** The routing decision (which chain, address, and fee) */
+    routing: RoutingDecision;
+    /** Current status of the send operation */
+    status: SendStatus;
+    /** Transaction hash (only when status is 'confirmed') */
+    txHash?: string;
+    /** Hex-encoded threshold signature (only when status is 'confirmed' or 'broadcasting') */
+    signature?: string;
+}
+/**
+ * Options for creating a new universal account.
+ */
+export interface CreateUniversalAccountOptions {
+    /** Signing threshold (default: 16) */
+    threshold?: number;
+    /** Total committee size (default: 24) */
+    committeeSize?: number;
+    /** Owner signature authorizing account creation */
+    ownerSignature: string;
+    /** Unix timestamp of the signature */
+    timestamp: number;
+}
+/**
+ * Network-wide statistics for the Universal Account protocol.
+ */
+export interface UniversalAccountStats {
+    /** Total number of universal accounts created */
+    totalAccounts: number;
+    /** Total number of derived chain addresses across all accounts */
+    totalAddresses: number;
+    /** Number of active (in-progress) send operations */
+    activeSends: number;
+}
+/**
+ * Client for the K7 Universal Account protocol.
+ *
+ * Communicates with universal account endpoints on the agent node
+ * to create accounts, query balances across all chains, and send
+ * tokens with automatic chain routing.
+ */
+export declare class UniversalAccountClient {
+    private baseUrl;
+    /**
+     * Create a new UniversalAccountClient.
+     *
+     * @param agentUrl - Agent node REST API URL (e.g., 'http://agent:8080')
+     * @param options - Optional client configuration
+     * @param options.timeout - Request timeout in milliseconds (default: 30000)
+     */
+    constructor(agentUrl: string, options?: {
+        timeout?: number;
+    });
+    /**
+     * Create a new universal account.
+     *
+     * Initiates DKG for both secp256k1 and ed25519 curves, derives
+     * addresses on all 81 supported chains, and registers the account
+     * on the Sequence0 chain.
+     *
+     * @param options - Account creation options
+     * @returns The created account information with all chain addresses
+     *
+     * @throws {Sequence0Error} If the creation parameters are invalid
+     * @throws {NetworkError} If the agent is unreachable
+     */
+    createAccount(options: CreateUniversalAccountOptions): Promise<UniversalAccountInfo>;
+    /**
+     * Get a universal account by its account ID.
+     *
+     * @param accountId - The unique account identifier
+     * @returns The account information
+     *
+     * @throws {Sequence0Error} If the account ID is invalid
+     * @throws {NetworkError} If the agent is unreachable or account not found
+     */
+    getAccount(accountId: string): Promise<UniversalAccountInfo>;
+    /**
+     * Look up a universal account by any of its chain addresses.
+     *
+     * Given an address on any chain (Ethereum, Bitcoin, Solana, etc.),
+     * returns the universal account that owns it.
+     *
+     * @param address - An address on any supported chain
+     * @returns The account information, or null if no account owns this address
+     *
+     * @throws {Sequence0Error} If the address is invalid
+     * @throws {NetworkError} If the agent is unreachable
+     */
+    getAccountByAddress(address: string): Promise<UniversalAccountInfo>;
+    /**
+     * Get all universal accounts owned by a specific owner address.
+     *
+     * @param ownerAddress - The Ethereum owner address
+     * @returns Array of account information objects
+     *
+     * @throws {Sequence0Error} If the owner address is invalid
+     * @throws {NetworkError} If the agent is unreachable
+     */
+    getOwnerAccounts(ownerAddress: string): Promise<UniversalAccountInfo[]>;
+    /**
+     * Deactivate a universal account.
+     *
+     * Marks the account as inactive. This does not destroy the keys
+     * or chain addresses — it prevents new sends from being initiated.
+     * Only the account owner can deactivate.
+     *
+     * @param accountId - The account ID to deactivate
+     * @param ownerSignature - Owner signature authorizing deactivation
+     * @param timestamp - Unix timestamp of the signature
+     *
+     * @throws {Sequence0Error} If parameters are invalid
+     * @throws {NetworkError} If the agent is unreachable
+     */
+    deactivateAccount(accountId: string, ownerSignature: string, timestamp: number): Promise<void>;
+    /**
+     * Get all chain addresses for a universal account.
+     *
+     * @param accountId - The account ID
+     * @returns Map of chain name to chain address info
+     *
+     * @throws {Sequence0Error} If the account ID is invalid
+     * @throws {NetworkError} If the agent is unreachable
+     */
+    getChainAddresses(accountId: string): Promise<Record<string, ChainAddressInfo>>;
+    /**
+     * Get the address for a specific chain within a universal account.
+     *
+     * @param accountId - The account ID
+     * @param chain - The chain name (e.g., 'ethereum', 'bitcoin', 'solana')
+     * @returns The chain address info
+     *
+     * @throws {Sequence0Error} If parameters are invalid
+     * @throws {NetworkError} If the agent is unreachable
+     */
+    getAddressForChain(accountId: string, chain: string): Promise<ChainAddressInfo>;
+    /**
+     * Get unified balance across all chains for a universal account.
+     *
+     * Agents query balances on all chains where the account has
+     * derived addresses and return an aggregated view.
+     *
+     * @param accountId - The account ID
+     * @returns Unified balance with per-chain breakdown
+     *
+     * @throws {Sequence0Error} If the account ID is invalid
+     * @throws {NetworkError} If the agent is unreachable
+     */
+    getUnifiedBalance(accountId: string): Promise<UnifiedBalance>;
+    /**
+     * Get the balance for a specific chain within a universal account.
+     *
+     * @param accountId - The account ID
+     * @param chain - The chain name (e.g., 'ethereum', 'bitcoin', 'solana')
+     * @returns The chain balance
+     *
+     * @throws {Sequence0Error} If parameters are invalid
+     * @throws {NetworkError} If the agent is unreachable
+     */
+    getChainBalance(accountId: string, chain: string): Promise<ChainBalance>;
+    /**
+     * Send tokens from a universal account.
+     *
+     * The agent network automatically selects the optimal source chain
+     * based on available balances, gas fees, and confirmation times.
+     * Use `preferredChain` to override automatic routing.
+     *
+     * @param options - Send options
+     * @returns The send result with routing decision and request ID for polling
+     *
+     * @throws {Sequence0Error} If the send parameters are invalid
+     * @throws {NetworkError} If the agent is unreachable
+     *
+     * @example
+     * ```typescript
+     * const result = await ua.send({
+     *   accountId: 'ua-abc123',
+     *   to: '0xRecipient...',
+     *   amount: '1.5',
+     *   token: 'ETH',
+     *   ownerSignature: '0x...',
+     *   timestamp: Date.now(),
+     * });
+     *
+     * // Poll for confirmation
+     * const status = await ua.getSendStatus(result.requestId);
+     * ```
+     */
+    send(options: UniversalSendOptions): Promise<SendResult>;
+    /**
+     * Get the current status of a send operation.
+     *
+     * @param requestId - The send request ID
+     * @returns Current status of the send
+     *
+     * @throws {Sequence0Error} If the request ID is invalid
+     * @throws {NetworkError} If the agent is unreachable
+     */
+    getSendStatus(requestId: string): Promise<SendResult>;
+    /**
+     * Wait for a send operation to reach a terminal status by polling.
+     *
+     * Polls the send status endpoint at 2-second intervals until
+     * the send is confirmed, fails, or the timeout is exceeded.
+     *
+     * @param requestId - The send request ID to wait for
+     * @param timeout - Max time to wait in ms (default: 120000)
+     * @returns The final send result
+     *
+     * @throws {TimeoutError} If the send is not completed within the timeout
+     * @throws {Sequence0Error} If the send fails
+     * @throws {NetworkError} If the agent is unreachable
+     */
+    waitForSend(requestId: string, timeout?: number): Promise<SendResult>;
+    /**
+     * Preview the routing decision for a send without executing it.
+     *
+     * Use this to show users which chain will be used and the estimated
+     * fee before they authorize the send with their signature.
+     *
+     * @param options - Send options (without ownerSignature and timestamp)
+     * @returns The routing decision that would be made
+     *
+     * @throws {Sequence0Error} If the parameters are invalid
+     * @throws {NetworkError} If the agent is unreachable
+     *
+     * @example
+     * ```typescript
+     * const route = await ua.previewRoute({
+     *   accountId: 'ua-abc123',
+     *   to: '0xRecipient...',
+     *   amount: '1.5',
+     *   token: 'ETH',
+     * });
+     * console.log(`Will send from ${route.sourceChain} (fee: ${route.estimatedFee})`);
+     * ```
+     */
+    previewRoute(options: Omit<UniversalSendOptions, 'ownerSignature' | 'timestamp'>): Promise<RoutingDecision>;
+    /**
+     * Get network-wide Universal Account statistics.
+     *
+     * @returns Protocol statistics
+     *
+     * @throws {NetworkError} If the agent is unreachable
+     */
+    getStats(): Promise<UniversalAccountStats>;
+    private get;
+    private post;
+    private mapAccountResponse;
+    private mapChainAddressResponse;
+    private mapChainBalanceResponse;
+    private mapUnifiedBalanceResponse;
+    private mapRoutingDecisionResponse;
+    private mapSendResultResponse;
+}
+//# sourceMappingURL=universal-account.d.ts.map

package/dist/core/universal-account.d.ts.map

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