@fivenorth/loop-sdk 0.10.0 → 0.11.1

package/README.md

@@ -237,6 +237,76 @@ Notes:
 
 Coming soon
 
+## Loop Server Signing API
+
+Loop SDK also supports a server-side signing flow. Instead of a wallet popup, your backend signs and submits transactions directly using the user's private key.
+
+### Installation
+
+For server-side usage, you need to install the SDK and `node-forge`:
+
+```bash
+bun add @fivenorth/loop-sdk node-forge
+# or
+npm install @fivenorth/loop-sdk node-forge
+```
+
+**Note:** `node-forge` is a peer dependency and must be installed manually when using the server SDK. It's not required for browser usage.
+
+### Usage
+
+```javascript
+import { loop } from '@fivenorth/loop-sdk/server';
+
+// Initialize with private key
+loop.init({
+    privateKey: process.env.PRIVATE_KEY, // hex-encoded Ed25519 private key
+    partyId: process.env.PARTY_ID,       // your party ID
+    network: 'local',                    // or 'devnet', 'mainnet'
+    walletUrl: process.env.WALLET_URL,   // optional
+    apiUrl: process.env.API_URL,         // optional
+});
+
+// Authenticate to get API access
+await loop.authenticate();
+
+// Get the provider to interact with the ledger
+const provider = loop.getProvider();
+
+// List holdings
+const holdings = await provider.getHolding();
+console.log(holdings);
+
+// Get active contracts
+const contracts = await provider.getActiveContracts({
+    templateId: '#splice-amulet:Splice.Amulet:Amulet'
+});
+
+// Transfer tokens
+const preparedPayload = await provider.transfer(
+    'recipient::partyId',
+    1,
+    {
+        instrument_admin: '',
+        instrument_id: 'Amulet',
+    },
+    {
+        requestedAt: new Date(),
+        executeBefore: new Date(Date.now() + 24 * 60 * 60 * 1000),
+    }
+);
+
+// Execute the transaction
+const result = await loop.executeTransaction(preparedPayload);
+console.log('Transfer result:', result);
+```
+
+Example ideas:
+- List pending transfers
+- Accept a pending transfer
+- Automated transaction processing
+
+
 # Development Guide
 
 This section is only if you want to actively develop the SDK itself. To use the SDK, follow the `#Usage Guide` section

package/dist/connection.d.ts

@@ -0,0 +1,40 @@
+import type { Network, Account, Holding, TransferRequest, PreparedTransferPayload, ExchangeApiKeyResponse, TransactionPayload, PreparedSubmissionResponse, ExecuteSubmissionResquest } from './types';
+import { SessionInfo } from './session';
+export declare class Connection {
+    walletUrl: string;
+    apiUrl: string;
+    ws: WebSocket | null;
+    private network;
+    private ticketId;
+    private onMessageHandler;
+    private reconnectPromise;
+    private status;
+    constructor({ network, walletUrl, apiUrl }: {
+        network?: Network;
+        walletUrl?: string;
+        apiUrl?: string;
+    });
+    connectInProgress(): boolean;
+    getTicket(appName: string, sessionId: string, version: string): Promise<{
+        ticket_id: string;
+    }>;
+    getHolding(authToken: string): Promise<Holding[]>;
+    getActiveContracts(authToken: string, params?: {
+        templateId?: string;
+        interfaceId?: string;
+    }): Promise<any[]>;
+    prepareTransfer(authToken: string, params: TransferRequest): Promise<PreparedTransferPayload>;
+    verifySession(authToken: string): Promise<Account>;
+    connectWebSocket(ticketId: string, onMessage: (event: MessageEvent) => void): void;
+    reconnect(): Promise<void>;
+    exchangeApiKey({ publicKey, signature, epoch }: {
+        publicKey: string;
+        signature: string;
+        epoch: number;
+    }): Promise<ExchangeApiKeyResponse>;
+    prepareTransaction(session: SessionInfo, params: TransactionPayload): Promise<PreparedSubmissionResponse>;
+    executeTransaction(session: SessionInfo, params: ExecuteSubmissionResquest): Promise<PreparedSubmissionResponse>;
+    private websocketUrl;
+    private attachWebSocket;
+}
+//# sourceMappingURL=connection.d.ts.map

package/dist/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,OAAO,EACP,OAAO,EACP,OAAO,EACP,eAAe,EACf,uBAAuB,EAEvB,sBAAsB,EACtB,kBAAkB,EAClB,0BAA0B,EAC1B,yBAAyB,EAC5B,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAGxC,qBAAa,UAAU;IACZ,SAAS,EAAE,MAAM,CAA4B;IAC7C,MAAM,EAAE,MAAM,CAA4B;IAC1C,EAAE,EAAE,SAAS,GAAG,IAAI,CAAQ;IACnC,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,gBAAgB,CAAgD;IACxE,OAAO,CAAC,gBAAgB,CAA8B;IACtD,OAAO,CAAC,MAAM,CAA+D;gBAEjE,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IAmCtG,iBAAiB,IAAI,OAAO;IAItB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAoB9F,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAgBjD,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAwB7G,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,uBAAuB,CAAC;IA4C7F,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAmCxD,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI;IAwB3E,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IA+BpB,cAAc,CAAC,EAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAC,EAAE;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAqB3I,kBAAkB,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAenG,kBAAkB,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,yBAAyB,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAwBtH,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,eAAe;CAqC1B"}

package/dist/connection.js

@@ -0,0 +1,290 @@
+import { UnauthorizedError } from './errors';
+import { generateRequestId } from './provider';
+export class Connection {
+    walletUrl = 'https://cantonloop.com';
+    apiUrl = 'https://cantonloop.com';
+    ws = null;
+    network = 'main';
+    ticketId = null;
+    onMessageHandler = null;
+    reconnectPromise = null;
+    status = 'disconnected';
+    constructor({ network, walletUrl, apiUrl }) {
+        this.network = network || 'main';
+        // Set default common value based on network
+        switch (this.network) {
+            case 'local':
+                this.walletUrl = 'http://localhost:3000';
+                this.apiUrl = 'http://localhost:8080';
+                break;
+            case 'devnet':
+            case 'dev':
+                this.walletUrl = 'https://devnet.cantonloop.com';
+                this.apiUrl = 'https://devnet.cantonloop.com';
+                break;
+            case 'testnet':
+            case 'test':
+                this.walletUrl = 'https://testnet.cantonloop.com';
+                this.apiUrl = 'https://testnet.cantonloop.com';
+                break;
+            case 'mainnet':
+            case 'main':
+                this.walletUrl = 'https://cantonloop.com';
+                this.apiUrl = 'https://cantonloop.com';
+                break;
+        }
+        // More useful when developing locally
+        if (walletUrl) {
+            this.walletUrl = walletUrl;
+        }
+        if (apiUrl) {
+            this.apiUrl = apiUrl;
+        }
+    }
+    connectInProgress() {
+        return this.status === 'connecting' || this.status === 'connected';
+    }
+    async getTicket(appName, sessionId, version) {
+        const response = await fetch(`${this.apiUrl}/api/v1/.connect/pair/tickets`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                app_name: appName,
+                session_id: sessionId,
+                version: version,
+            }),
+        });
+        if (!response.ok) {
+            throw new Error('Failed to get ticket from server.');
+        }
+        return response.json();
+    }
+    async getHolding(authToken) {
+        const response = await fetch(`${this.apiUrl}/api/v1/.connect/pair/account/holding`, {
+            method: 'GET',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${authToken}`,
+            },
+        });
+        if (!response.ok) {
+            throw new Error('Failed to get holdings. ' + await response.text());
+        }
+        return response.json();
+    }
+    async getActiveContracts(authToken, params) {
+        const url = new URL(`${this.apiUrl}/api/v1/.connect/pair/account/active-contracts`);
+        if (params?.templateId) {
+            url.searchParams.append('templateId', params.templateId);
+        }
+        if (params?.interfaceId) {
+            url.searchParams.append('interfaceId', params.interfaceId);
+        }
+        const response = await fetch(url.toString(), {
+            method: 'GET',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${authToken}`,
+            },
+        });
+        if (!response.ok) {
+            throw new Error('Failed to get active contracts.');
+        }
+        return response.json();
+    }
+    async prepareTransfer(authToken, params) {
+        const payload = {
+            recipient: params.recipient,
+            amount: params.amount,
+        };
+        if (params.instrument) {
+            if (params.instrument.instrument_admin) {
+                payload.instrument_admin = params.instrument.instrument_admin;
+            }
+            if (params.instrument.instrument_id) {
+                payload.instrument_id = params.instrument.instrument_id;
+            }
+        }
+        if (params.requested_at) {
+            payload.requested_at = params.requested_at;
+        }
+        if (params.execute_before) {
+            payload.execute_before = params.execute_before;
+        }
+        if (params.memo) {
+            payload.memo = params.memo;
+        }
+        const response = await fetch(`${this.apiUrl}/api/v1/.connect/pair/transfer`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${authToken}`,
+            },
+            body: JSON.stringify(payload),
+        });
+        if (!response.ok) {
+            console.error('Failed to prepare transfer.', await response.text());
+            throw new Error('Failed to prepare transfer.');
+        }
+        const data = await response.json();
+        return data.payload;
+    }
+    async verifySession(authToken) {
+        const response = await fetch(`${this.apiUrl}/api/v1/.connect/pair/account`, {
+            method: 'GET',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${authToken}`,
+            },
+        });
+        if (!response.ok) {
+            if (response.status === 401 || response.status === 403) {
+                throw new UnauthorizedError();
+            }
+            throw new Error(`Session verification failed with status ${response.status}.`);
+        }
+        const data = await response.json();
+        const email = data?.email;
+        if (!data?.party_id || !data?.public_key) {
+            throw new Error('Invalid session verification response.');
+        }
+        // Map fields from the response to the account object, handling camelCase and snake_case.
+        const account = {
+            party_id: data?.party_id,
+            auth_token: authToken,
+            public_key: data?.public_key,
+            email,
+            has_preapproval: data?.has_preapproval,
+            has_merge_delegation: data?.has_merge_delegation,
+            usdc_bridge_access: data?.usdc_bridge_access,
+        };
+        return account;
+    }
+    connectWebSocket(ticketId, onMessage) {
+        if (this.ws &&
+            (this.ws.readyState === WebSocket.OPEN || this.ws.readyState === WebSocket.CONNECTING) &&
+            this.ticketId !== ticketId) {
+            // When connecting to a new ticket, we need to close the existing socket first
+            this.ws.close();
+            this.ws = null;
+        }
+        // prevent opening multiple sockets for same ticket
+        if (this.status === 'connecting' || this.status === 'connected') {
+            return;
+        }
+        // set the message handler and ticket id to re-use for reconnecting
+        this.onMessageHandler = onMessage;
+        this.ticketId = ticketId;
+        this.status = 'connecting';
+        this.attachWebSocket(ticketId, onMessage);
+    }
+    reconnect() {
+        if (!this.ticketId || !this.onMessageHandler) {
+            return Promise.reject(new Error('Cannot reconnect without a known ticket.'));
+        }
+        return new Promise((resolve, reject) => {
+            let opened = false;
+            this.attachWebSocket(this.ticketId, this.onMessageHandler, () => {
+                opened = true;
+                resolve();
+            }, () => {
+                if (opened) {
+                    return;
+                }
+                reject(new Error('Failed to reconnect to ticket server.'));
+            }, () => {
+                if (opened) {
+                    return;
+                }
+                reject(new Error('Failed to reconnect to ticket server.'));
+            });
+        });
+    }
+    // exchangeApiKey is used to exchange the API key for the public key and signature to use in a server session
+    async exchangeApiKey({ publicKey, signature, epoch }) {
+        const response = await fetch(`${this.apiUrl}/api/v1/.connect/pair/apikey`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                public_key: publicKey,
+                signature: signature,
+                epoch: epoch,
+            })
+        });
+        if (!response.ok) {
+            throw new Error('Failed to get API key from server.');
+        }
+        return response.json();
+    }
+    // send transaction to v2/interactive-submisison/prepare endpoint to get the prepared transaction
+    prepareTransaction(session, params) {
+        return fetch(`${this.apiUrl}/api/v1/.connect/tickets/prepare-transaction`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${session.userApiKey}`,
+            },
+            body: JSON.stringify({
+                payload: params,
+                ticket_id: session.ticketId,
+            })
+        }).then(response => response.json());
+    }
+    // execute a signed transaction with v2/interactive-submisison/execute endpoint
+    async executeTransaction(session, params) {
+        if (!session.ticketId) {
+            throw new Error('Ticket ID is required');
+        }
+        const resp = fetch(`${this.apiUrl}/api/v1/.connect/tickets/execute-transaction`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${session.userApiKey}`,
+            },
+            body: JSON.stringify({
+                ticket_id: session.ticketId,
+                request_id: generateRequestId(),
+                command_id: params.command_id,
+                signature: params.signature,
+                transaction_data: params.transaction_data,
+            }),
+        });
+        return (await resp).json();
+    }
+    websocketUrl(ticketId) {
+        return `${this.network === 'local' ? 'ws' : 'wss'}://${this.apiUrl.replace('https://', '').replace('http://', '')}/api/v1/.connect/pair/ws/${encodeURIComponent(ticketId)}`;
+    }
+    // attachWebSocket is a helper function to setup even handler on a websocket object and assign to our ws 
+    attachWebSocket(ticketId, onMessage, onOpen, onError, onClose) {
+        const wsUrl = this.websocketUrl(ticketId);
+        const ws = new WebSocket(wsUrl);
+        ws.onmessage = onMessage;
+        ws.onopen = () => {
+            this.status = 'connected';
+            console.log('[LoopSDK] Connected to ticket server.');
+            onOpen?.();
+        };
+        ws.onclose = (event) => {
+            this.status = 'disconnected';
+            if (this.ws === ws) {
+                this.ws = null;
+            }
+            console.log('[LoopSDK] Disconnected from ticket server.');
+            onClose?.(event);
+        };
+        ws.onerror = (event) => {
+            // if it's already close, another close is a no-op
+            this.status = 'disconnected';
+            ws.close();
+            if (this.ws === ws) {
+                this.ws = null;
+            }
+            onError?.(event);
+        };
+        this.ws = ws;
+    }
+}

package/dist/errors.d.ts

@@ -0,0 +1,13 @@
+export declare class RequestTimeoutError extends Error {
+    constructor(timeout: number);
+}
+export declare class RejectRequestError extends Error {
+    constructor();
+}
+export declare class UnauthorizedError extends Error {
+    code?: string;
+    constructor(code?: string);
+}
+export declare function extractErrorCode(message: any): string | null;
+export declare function isUnauthCode(code: string | null | undefined): code is string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,mBAAoB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM;CAG9B;AAED,qBAAa,kBAAmB,SAAQ,KAAK;;CAI5C;AAED,qBAAa,iBAAkB,SAAQ,KAAK;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;gBACT,IAAI,CAAC,EAAE,MAAM;CAI5B;AAID,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,GAAG,GAAG,MAAM,GAAG,IAAI,CAQ5D;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,IAAI,MAAM,CAK5E"}

package/dist/errors.js

@@ -0,0 +1,33 @@
+export class RequestTimeoutError extends Error {
+    constructor(timeout) {
+        super(`Request timed out after ${timeout}ms.`);
+    }
+}
+export class RejectRequestError extends Error {
+    constructor() {
+        super('Request was rejected by the wallet.');
+    }
+}
+export class UnauthorizedError extends Error {
+    code;
+    constructor(code) {
+        super(code || 'Unauthorized');
+        this.code = code;
+    }
+}
+const UNAUTH_CODES = new Set(['UNAUTHENTICATED', 'UNAUTHORIZED', 'SESSION_EXPIRED', 'LOGGED_OUT']);
+export function extractErrorCode(message) {
+    if (typeof message?.error?.code === 'string' && message.error.code.length > 0) {
+        return message.error.code;
+    }
+    if (message?.type === 'unauthorized' && typeof message?.code === 'string') {
+        return message.code;
+    }
+    return null;
+}
+export function isUnauthCode(code) {
+    if (!code) {
+        return false;
+    }
+    return UNAUTH_CODES.has(code);
+}

package/dist/extensions/usdc/index.d.ts

@@ -0,0 +1,11 @@
+import type { WithdrawOptions, UsdcBridgeExtension, WithdrawUsdcRequest, PreparedWithdrawPayload } from './types';
+import type { Provider } from '../../provider';
+import type { Connection } from '../../connection';
+export declare class UsdcBridge implements UsdcBridgeExtension {
+    private getProvider;
+    constructor(getProvider: () => Provider | null);
+    private requireProvider;
+    withdrawalUSDCxToEthereum(recipient: string, amount: string | number, options?: WithdrawOptions): Promise<any>;
+}
+export declare function prepareUsdcWithdraw(connection: Connection, authToken: string, params: WithdrawUsdcRequest): Promise<PreparedWithdrawPayload>;
+//# sourceMappingURL=index.d.ts.map

package/dist/extensions/usdc/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/extensions/usdc/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,uBAAuB,EAA2B,MAAM,SAAS,CAAC;AAC3I,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,qBAAa,UAAW,YAAW,mBAAmB;IACpD,OAAO,CAAC,WAAW,CAAwB;gBAE/B,WAAW,EAAE,MAAM,QAAQ,GAAG,IAAI;IAI9C,OAAO,CAAC,eAAe;IAQvB,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC;CAwB/G;AAED,wBAAsB,mBAAmB,CAAC,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAyBlJ"}

package/dist/extensions/usdc/index.js

@@ -0,0 +1,52 @@
+export class UsdcBridge {
+    getProvider;
+    constructor(getProvider) {
+        this.getProvider = getProvider;
+    }
+    requireProvider() {
+        const provider = this.getProvider();
+        if (!provider) {
+            throw new Error('SDK not connected. Call connect() and wait for acceptance first.');
+        }
+        return provider;
+    }
+    withdrawalUSDCxToEthereum(recipient, amount, options) {
+        const provider = this.requireProvider();
+        const amountStr = typeof amount === 'number' ? amount.toString() : amount;
+        const withdrawRequest = {
+            recipient,
+            amount: amountStr,
+            reference: options?.reference,
+        };
+        return prepareUsdcWithdraw(provider.connection, provider.getAuthToken(), withdrawRequest).then((preparedPayload) => provider.submitTransaction({
+            commands: preparedPayload.commands,
+            disclosedContracts: preparedPayload.disclosedContracts,
+            packageIdSelectionPreference: preparedPayload.packageIdSelectionPreference,
+            actAs: preparedPayload.actAs,
+            readAs: preparedPayload.readAs,
+            synchronizerId: preparedPayload.synchronizerId,
+        }, { requestTimeout: options?.requestTimeout, message: options?.message }));
+    }
+}
+export async function prepareUsdcWithdraw(connection, authToken, params) {
+    const payload = {
+        recipient: params.recipient,
+        amount: params.amount,
+    };
+    if (params.reference) {
+        payload.reference = params.reference;
+    }
+    const response = await fetch(`${connection.apiUrl}/api/v1/.connect/pair/usdc/withdraw`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'Authorization': `Bearer ${authToken}`,
+        },
+        body: JSON.stringify(payload),
+    });
+    if (!response.ok) {
+        throw new Error('Failed to prepare USDC withdrawal.');
+    }
+    const data = await response.json();
+    return data.payload;
+}

package/dist/extensions/usdc/types.d.ts

@@ -0,0 +1,25 @@
+export type WithdrawUsdcRequest = {
+    recipient: string;
+    amount: string;
+    reference?: string;
+};
+export type PreparedWithdrawPayload = {
+    actAs: string[];
+    readAs: string[];
+    synchronizerId: string;
+    commands: any[];
+    disclosedContracts: any[];
+    packageIdSelectionPreference: string[];
+};
+export type ConnectWithdrawResponse = {
+    payload: PreparedWithdrawPayload;
+};
+export type WithdrawOptions = {
+    reference?: string;
+    requestTimeout?: number;
+    message?: string;
+};
+export interface UsdcBridgeExtension {
+    withdrawalUSDCxToEthereum(recipient: string, amount: string | number, options?: WithdrawOptions): Promise<any>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/extensions/usdc/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/extensions/usdc/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,GAAG,EAAE,CAAC;IAChB,kBAAkB,EAAE,GAAG,EAAE,CAAC;IAC1B,4BAA4B,EAAE,MAAM,EAAE,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,uBAAuB,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CAChH"}

package/dist/extensions/usdc/types.js

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

package/dist/index.d.ts

@@ -0,0 +1,53 @@
+import { Provider } from "./provider";
+import type { Network, Wallet, RunTransactionResponse } from "./types";
+declare class LoopSDK {
+    private version;
+    private appName;
+    private connection;
+    private session;
+    private provider;
+    private openMode;
+    private requestSigningMode;
+    private popupWindow;
+    private redirectUrl?;
+    private onAccept;
+    private onReject;
+    private onTransactionUpdate;
+    private overlay;
+    wallet: Wallet;
+    constructor();
+    init({ appName, network, walletUrl, apiUrl, onAccept, onReject, onTransactionUpdate, options, }: {
+        appName: string;
+        network?: Network;
+        walletUrl?: string;
+        apiUrl?: string;
+        onAccept?: (provider: Provider) => void;
+        onReject?: () => void;
+        onTransactionUpdate?: (payload: RunTransactionResponse, message: any) => void;
+        options?: {
+            openMode?: "popup" | "tab";
+            requestSigningMode?: "popup" | "tab";
+            redirectUrl?: string;
+        };
+    }): void;
+    private loadSessionInfo;
+    autoConnect(): Promise<void>;
+    connect(): Promise<void>;
+    private handleWebSocketMessage;
+    getConnectUrl(): string;
+    private buildConnectUrl;
+    private buildDashboardUrl;
+    private openRequestUi;
+    private closePopupIfExists;
+    private openWallet;
+    private injectModalStyles;
+    private showQrCode;
+    private hideQrCode;
+    logout(): void;
+    private requireProvider;
+    private createProviderHooks;
+}
+export declare const loop: LoopSDK;
+export * from "./extensions/usdc/types";
+export * from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAqB,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEzD,OAAO,KAAK,EAGX,OAAO,EAEP,MAAM,EACN,sBAAsB,EACtB,MAAM,SAAS,CAAC;AAIjB,cAAM,OAAO;IACZ,OAAO,CAAC,OAAO,CAAmB;IAElC,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,QAAQ,CAA4B;IAC5C,OAAO,CAAC,kBAAkB,CAA4B;IACtD,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,WAAW,CAAC,CAAS;IAE7B,OAAO,CAAC,QAAQ,CAA+C;IAC/D,OAAO,CAAC,QAAQ,CAA6B;IAC3C,OAAO,CAAC,mBAAmB,CAA0E;IACvG,OAAO,CAAC,OAAO,CAA+B;IACvC,MAAM,EAAE,MAAM,CAAC;;IAMtB,IAAI,CAAC,EACJ,OAAO,EACP,OAAO,EACP,SAAS,EACT,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,mBAAmB,EACnB,OAAO,GACP,EAAE;QACF,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;QACxC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;QACtB,mBAAmB,CAAC,EAAE,CAAC,OAAO,EAAE,sBAAsB,EAAE,OAAO,EAAE,GAAG,KAAK,IAAI,CAAC;QAC9E,OAAO,CAAC,EAAE;YACT,QAAQ,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;YAC3B,kBAAkB,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;YACrC,WAAW,CAAC,EAAE,MAAM,CAAC;SACrB,CAAC;KACF;YAiCa,eAAe;IA6CvB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IA8B5B,OAAO;IA2Cb,OAAO,CAAC,sBAAsB;IA8DvB,aAAa,IAAI,MAAM;IAO9B,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,aAAa;IAqBrB,OAAO,CAAC,kBAAkB;IAW1B,OAAO,CAAC,UAAU;IAuClB,OAAO,CAAC,iBAAiB;IAyIzB,OAAO,CAAC,UAAU;IAoFlB,OAAO,CAAC,UAAU;IAOlB,MAAM;IAQN,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,mBAAmB;CAe3B;AAED,eAAO,MAAM,IAAI,SAAgB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,SAAS,CAAC"}