@pollar/core 0.9.0-rc.2 → 0.9.0-rc.3

package/dist/index.d.mts

@@ -344,12 +344,17 @@ interface PollarClientConfig {
  * Runs the device WebAuthn ceremony for a server-issued challenge and returns
  * the result to forward to the backend: a registration response for a new user
  * (`create()`) or an authentication assertion for a returning one (`get()`).
- * The implementation decides which (e.g. try `get()` first, fall back to
- * `create()`). `response` is the browser's PublicKeyCredential serialized to
- * JSON — forwarded verbatim to `/auth/passkey/{register,login}`.
+ * `mode` tells the ceremony which to run: `'login'` runs `get()` only (returning
+ * user) and `'register'` runs `create()` only (new wallet) — the caller picks via
+ * the "Log in" / "Create wallet" buttons, so there's no ambiguous autodetect that
+ * could create a wallet when the user merely cancelled a login prompt. `response`
+ * is the browser's PublicKeyCredential serialized to JSON — forwarded verbatim to
+ * `/auth/passkey/{register,login}`.
  */
+type PasskeyMode = 'login' | 'register';
 type PasskeyCeremony = (ctx: {
     challenge: string;
+    mode: PasskeyMode;
 }) => Promise<{
     kind: 'login';
     response: unknown;
@@ -558,6 +563,22 @@ type SubmitOutcome = {
     resultCode?: string;
     buildData?: TxBuildContent;
 };
+/**
+ * Result of {@link PollarClient.setTrustline}. Like {@link SubmitOutcome} but the
+ * `hash` is optional: the sponsored, server-orchestrated path completes without
+ * surfacing a transaction hash to the client, whereas the self-paid path returns
+ * the underlying submit outcome (hash included).
+ */
+type TrustlineOutcome = {
+    status: 'success';
+    hash?: string;
+} | {
+    status: 'pending';
+    hash?: string;
+} | {
+    status: 'error';
+    details?: string;
+};
 declare const AUTH_ERROR_CODES: {
     readonly SESSION_CREATE_FAILED: "SESSION_CREATE_FAILED";
     readonly SESSION_EXPIRED: "SESSION_EXPIRED";
@@ -871,11 +892,19 @@ declare class PollarClient {
     verifyEmailCode(code: string): void;
     loginWallet(type: WalletId): void;
     /**
-     * "Smart Wallet" login: runs the passkey (WebAuthn) ceremony and, for a new
-     * user, creates a sponsored smart-account C-address. Requires the `passkey`
-     * ceremony to be configured (e.g. via `@pollar/react`).
+     * "Smart Wallet" login: runs the passkey (WebAuthn) `get()` ceremony for a
+     * returning user and signs them in. Use {@link createSmartWallet} for a new
+     * user. Requires the `passkey` ceremony to be configured (e.g. via
+     * `@pollar/react`).
      */
     loginSmartWallet(): void;
+    /**
+     * "Smart Wallet" registration: runs the passkey (WebAuthn) `create()` ceremony
+     * for a new user and deploys a sponsored smart-account C-address. Use
+     * {@link loginSmartWallet} for a returning user. Requires the `passkey`
+     * ceremony to be configured (e.g. via `@pollar/react`).
+     */
+    createSmartWallet(): void;
     cancelLogin(): void;
     /**
      * Revoke the current session server-side, then clear local storage.
@@ -952,6 +981,27 @@ declare class PollarClient {
      * session. Drives `enabledAssetsState`; mirrors {@link refreshBalance}.
      */
     refreshAssets(): Promise<void>;
+    /**
+     * Establishes (omit `limit`) or removes (`limit: '0'`) a trustline for an asset.
+     *
+     * Routing mirrors how the platform pays for the reserve:
+     *  - **Sponsored custodial** (`opts.sponsored` true, internal wallet) → the
+     *    server orchestrates a sponsored `changeTrust`: the app's wallets cover the
+     *    0.5 XLM reserve and the fee, so the user pays nothing. Pass the asset's
+     *    `sponsored` flag (from {@link refreshAssets}) straight through.
+     *  - **Self-paid** (external/adapter wallet, sponsorship disabled, or a custom
+     *    asset not configured in the app) → a plain `change_trust` transaction the
+     *    user's own wallet signs and pays for, via {@link runTx}.
+     *
+     * Does not refresh on its own — callers should `refreshAssets()` afterwards.
+     */
+    setTrustline(asset: {
+        code: string;
+        issuer: string;
+    }, opts?: {
+        limit?: string;
+        sponsored?: boolean;
+    }): Promise<TrustlineOutcome>;
     /**
      * Builds an unsigned XDR. Drives `_setTransactionState` for modal-style UIs
      * AND returns a {@link BuildOutcome} so headless callers can `await` and
@@ -1957,6 +2007,26 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/wallet/assets/trustline": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Enable or remove a trustline for an enabled asset
+         * @description Establishes (no limit) or removes (limit '0') a trustline on the authenticated user's custodial wallet for an asset configured in the application, sponsored by the app. Returns the refreshed enabled-asset list. Only valid for the sponsored custodial path; custom assets, adapter-managed wallets, and apps with trustline sponsoring disabled must sign a change_trust transaction client-side instead.
+         */
+        post: operations["postWalletAssetsTrustline"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/wallet/{publicKey}/balance": {
         parameters: {
             query?: never;
@@ -3653,6 +3723,7 @@ interface operations {
                                 logoUrl?: string;
                                 emailEnabled?: boolean;
                                 embeddedWallets?: boolean;
+                                smartWallet?: boolean;
                                 providers?: {
                                     google?: boolean;
                                     discord?: boolean;
@@ -5014,6 +5085,8 @@ interface operations {
                                 name?: string;
                                 trustlineEstablished: boolean;
                                 limit?: string;
+                                enabledInApp: boolean;
+                                sponsored?: boolean;
                             }[];
                         };
                     };
@@ -5047,6 +5120,95 @@ interface operations {
             };
         };
     };
+    postWalletAssetsTrustline: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    code: string;
+                    issuer: string;
+                    limit?: string;
+                };
+            };
+        };
+        responses: {
+            /** @description Trustline updated; refreshed enabled assets */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        code: "SDK_WALLET_TRUSTLINE";
+                        /** @constant */
+                        success: true;
+                        content: {
+                            publicKey: string;
+                            /** @enum {string} */
+                            network: "testnet" | "mainnet";
+                            exists: boolean;
+                            assets: {
+                                /** @enum {string} */
+                                type: "native" | "credit_alphanum4" | "credit_alphanum12";
+                                code: string;
+                                issuer?: string;
+                                name?: string;
+                                trustlineEstablished: boolean;
+                                limit?: string;
+                                enabledInApp: boolean;
+                                sponsored?: boolean;
+                            }[];
+                        };
+                    };
+                };
+            };
+            /** @description Validation error */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        success: false;
+                        code: string;
+                    };
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        success: false;
+                        code: string;
+                    };
+                };
+            };
+            /** @description Not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        success: false;
+                        code: string;
+                    };
+                };
+            };
+        };
+    };
     getWalletByPublicKeyBalance: {
         parameters: {
             query: {
@@ -5897,4 +6059,4 @@ declare function listDistributionRules(api: PollarApiClient): Promise<Distributi
  */
 declare function claimDistributionRule(api: PollarApiClient, body: DistributionClaimBody): Promise<DistributionClaimContent>;
 
-export { AUTH_ERROR_CODES, type AdapterFn, AlbedoAdapter, type AuthErrorCode, type AuthOpenContext, type AuthState, type AuthUrlOpener, type BuildOutcome, type BuildProofArgs, type ConnectWalletResponse, type DistributionClaimBody, type DistributionClaimContent, type DistributionRule, type DistributionRulesState, type EnabledAssetRecord, type EnabledAssetsState, FreighterAdapter, type KeyManager, type KycFlow, type KycLevel, type KycProvider, type KycStartBody, type KycStartResponse, type KycStatus, type LocalStorageAdapterOptions, type LogLevel, type NetworkState, OnStorageDegrade, POLLAR_CORE_VERSION, type PasskeyCeremony, type PasskeySigner, type PaymentInstructions, type PollarAdapter, type PollarAdapters, type PollarApiClient, type PollarApplicationConfigContent, type PollarApplicationConfigResponse, PollarClient, type PollarClientConfig, PollarFlowError, type PollarLogger, type PollarLoginOptions, type PollarPersistedSession, type PollarUserProfile, type PublicEcJwk, type RampDirection, type RampQuote, type RampTxStatus, type RampsOfframpBody, type RampsOfframpResponse, type RampsOnrampBody, type RampsOnrampResponse, type RampsQuoteQuery, type RampsQuoteResponse, type RampsTransactionResponse, type RulePeriod, type SessionInfo, type SessionsState, type SignAuthEntryOptions, type SignAuthEntryResponse, type SignOutcome, type SignTransactionOptions, type SignTransactionResponse, type StellarBalance, StellarClient, type StellarClientConfig, type StellarNetwork, Storage, type SubmitOutcome, type TransactionState, type TxBuildBody, type TxBuildContent, type TxBuildResponse, type TxBuildSignSubmitBody, type TxBuildSignSubmitContent, type TxBuildSignSubmitResponse, type TxErrorPhase, type TxHistoryContent, type TxHistoryParams, type TxHistoryRecord, type TxHistoryState, type TxSignAndSendBody, type TxSignBody, type TxSignContent, type TxSignResponse, type TxSignSendResponse, type TxSubmitSignedBody, type WalletAdapter, type WalletAdapterResolver, type WalletAssetsContent, type WalletBalanceContent, type WalletBalanceRecord, type WalletBalanceState, type WalletId, WalletType, WebCryptoKeyManager, buildProof, canonicalEcJwk, claimDistributionRule, computeJwkThumbprint, createLocalStorageAdapter, createLogger, createMemoryAdapter, createOffRamp, createOnRamp, defaultKeyManager, defaultStorage, getKycProviders, getKycStatus, getRampTransaction, getRampsQuote, isValidSession, listDistributionRules, normalizeHtu, pollKycStatus, pollRampTransaction, type paths as pollarPaths, resolveKyc, startKyc };
+export { AUTH_ERROR_CODES, type AdapterFn, AlbedoAdapter, type AuthErrorCode, type AuthOpenContext, type AuthState, type AuthUrlOpener, type BuildOutcome, type BuildProofArgs, type ConnectWalletResponse, type DistributionClaimBody, type DistributionClaimContent, type DistributionRule, type DistributionRulesState, type EnabledAssetRecord, type EnabledAssetsState, FreighterAdapter, type KeyManager, type KycFlow, type KycLevel, type KycProvider, type KycStartBody, type KycStartResponse, type KycStatus, type LocalStorageAdapterOptions, type LogLevel, type NetworkState, OnStorageDegrade, POLLAR_CORE_VERSION, type PasskeyCeremony, type PasskeyMode, type PasskeySigner, type PaymentInstructions, type PollarAdapter, type PollarAdapters, type PollarApiClient, type PollarApplicationConfigContent, type PollarApplicationConfigResponse, PollarClient, type PollarClientConfig, PollarFlowError, type PollarLogger, type PollarLoginOptions, type PollarPersistedSession, type PollarUserProfile, type PublicEcJwk, type RampDirection, type RampQuote, type RampTxStatus, type RampsOfframpBody, type RampsOfframpResponse, type RampsOnrampBody, type RampsOnrampResponse, type RampsQuoteQuery, type RampsQuoteResponse, type RampsTransactionResponse, type RulePeriod, type SessionInfo, type SessionsState, type SignAuthEntryOptions, type SignAuthEntryResponse, type SignOutcome, type SignTransactionOptions, type SignTransactionResponse, type StellarBalance, StellarClient, type StellarClientConfig, type StellarNetwork, Storage, type SubmitOutcome, type TransactionState, type TrustlineOutcome, type TxBuildBody, type TxBuildContent, type TxBuildResponse, type TxBuildSignSubmitBody, type TxBuildSignSubmitContent, type TxBuildSignSubmitResponse, type TxErrorPhase, type TxHistoryContent, type TxHistoryParams, type TxHistoryRecord, type TxHistoryState, type TxSignAndSendBody, type TxSignBody, type TxSignContent, type TxSignResponse, type TxSignSendResponse, type TxSubmitSignedBody, type WalletAdapter, type WalletAdapterResolver, type WalletAssetsContent, type WalletBalanceContent, type WalletBalanceRecord, type WalletBalanceState, type WalletId, WalletType, WebCryptoKeyManager, buildProof, canonicalEcJwk, claimDistributionRule, computeJwkThumbprint, createLocalStorageAdapter, createLogger, createMemoryAdapter, createOffRamp, createOnRamp, defaultKeyManager, defaultStorage, getKycProviders, getKycStatus, getRampTransaction, getRampsQuote, isValidSession, listDistributionRules, normalizeHtu, pollKycStatus, pollRampTransaction, type paths as pollarPaths, resolveKyc, startKyc };

package/dist/index.d.ts

@@ -344,12 +344,17 @@ interface PollarClientConfig {
  * Runs the device WebAuthn ceremony for a server-issued challenge and returns
  * the result to forward to the backend: a registration response for a new user
  * (`create()`) or an authentication assertion for a returning one (`get()`).
- * The implementation decides which (e.g. try `get()` first, fall back to
- * `create()`). `response` is the browser's PublicKeyCredential serialized to
- * JSON — forwarded verbatim to `/auth/passkey/{register,login}`.
+ * `mode` tells the ceremony which to run: `'login'` runs `get()` only (returning
+ * user) and `'register'` runs `create()` only (new wallet) — the caller picks via
+ * the "Log in" / "Create wallet" buttons, so there's no ambiguous autodetect that
+ * could create a wallet when the user merely cancelled a login prompt. `response`
+ * is the browser's PublicKeyCredential serialized to JSON — forwarded verbatim to
+ * `/auth/passkey/{register,login}`.
  */
+type PasskeyMode = 'login' | 'register';
 type PasskeyCeremony = (ctx: {
     challenge: string;
+    mode: PasskeyMode;
 }) => Promise<{
     kind: 'login';
     response: unknown;
@@ -558,6 +563,22 @@ type SubmitOutcome = {
     resultCode?: string;
     buildData?: TxBuildContent;
 };
+/**
+ * Result of {@link PollarClient.setTrustline}. Like {@link SubmitOutcome} but the
+ * `hash` is optional: the sponsored, server-orchestrated path completes without
+ * surfacing a transaction hash to the client, whereas the self-paid path returns
+ * the underlying submit outcome (hash included).
+ */
+type TrustlineOutcome = {
+    status: 'success';
+    hash?: string;
+} | {
+    status: 'pending';
+    hash?: string;
+} | {
+    status: 'error';
+    details?: string;
+};
 declare const AUTH_ERROR_CODES: {
     readonly SESSION_CREATE_FAILED: "SESSION_CREATE_FAILED";
     readonly SESSION_EXPIRED: "SESSION_EXPIRED";
@@ -871,11 +892,19 @@ declare class PollarClient {
     verifyEmailCode(code: string): void;
     loginWallet(type: WalletId): void;
     /**
-     * "Smart Wallet" login: runs the passkey (WebAuthn) ceremony and, for a new
-     * user, creates a sponsored smart-account C-address. Requires the `passkey`
-     * ceremony to be configured (e.g. via `@pollar/react`).
+     * "Smart Wallet" login: runs the passkey (WebAuthn) `get()` ceremony for a
+     * returning user and signs them in. Use {@link createSmartWallet} for a new
+     * user. Requires the `passkey` ceremony to be configured (e.g. via
+     * `@pollar/react`).
      */
     loginSmartWallet(): void;
+    /**
+     * "Smart Wallet" registration: runs the passkey (WebAuthn) `create()` ceremony
+     * for a new user and deploys a sponsored smart-account C-address. Use
+     * {@link loginSmartWallet} for a returning user. Requires the `passkey`
+     * ceremony to be configured (e.g. via `@pollar/react`).
+     */
+    createSmartWallet(): void;
     cancelLogin(): void;
     /**
      * Revoke the current session server-side, then clear local storage.
@@ -952,6 +981,27 @@ declare class PollarClient {
      * session. Drives `enabledAssetsState`; mirrors {@link refreshBalance}.
      */
     refreshAssets(): Promise<void>;
+    /**
+     * Establishes (omit `limit`) or removes (`limit: '0'`) a trustline for an asset.
+     *
+     * Routing mirrors how the platform pays for the reserve:
+     *  - **Sponsored custodial** (`opts.sponsored` true, internal wallet) → the
+     *    server orchestrates a sponsored `changeTrust`: the app's wallets cover the
+     *    0.5 XLM reserve and the fee, so the user pays nothing. Pass the asset's
+     *    `sponsored` flag (from {@link refreshAssets}) straight through.
+     *  - **Self-paid** (external/adapter wallet, sponsorship disabled, or a custom
+     *    asset not configured in the app) → a plain `change_trust` transaction the
+     *    user's own wallet signs and pays for, via {@link runTx}.
+     *
+     * Does not refresh on its own — callers should `refreshAssets()` afterwards.
+     */
+    setTrustline(asset: {
+        code: string;
+        issuer: string;
+    }, opts?: {
+        limit?: string;
+        sponsored?: boolean;
+    }): Promise<TrustlineOutcome>;
     /**
      * Builds an unsigned XDR. Drives `_setTransactionState` for modal-style UIs
      * AND returns a {@link BuildOutcome} so headless callers can `await` and
@@ -1957,6 +2007,26 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/wallet/assets/trustline": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Enable or remove a trustline for an enabled asset
+         * @description Establishes (no limit) or removes (limit '0') a trustline on the authenticated user's custodial wallet for an asset configured in the application, sponsored by the app. Returns the refreshed enabled-asset list. Only valid for the sponsored custodial path; custom assets, adapter-managed wallets, and apps with trustline sponsoring disabled must sign a change_trust transaction client-side instead.
+         */
+        post: operations["postWalletAssetsTrustline"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/wallet/{publicKey}/balance": {
         parameters: {
             query?: never;
@@ -3653,6 +3723,7 @@ interface operations {
                                 logoUrl?: string;
                                 emailEnabled?: boolean;
                                 embeddedWallets?: boolean;
+                                smartWallet?: boolean;
                                 providers?: {
                                     google?: boolean;
                                     discord?: boolean;
@@ -5014,6 +5085,8 @@ interface operations {
                                 name?: string;
                                 trustlineEstablished: boolean;
                                 limit?: string;
+                                enabledInApp: boolean;
+                                sponsored?: boolean;
                             }[];
                         };
                     };
@@ -5047,6 +5120,95 @@ interface operations {
             };
         };
     };
+    postWalletAssetsTrustline: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    code: string;
+                    issuer: string;
+                    limit?: string;
+                };
+            };
+        };
+        responses: {
+            /** @description Trustline updated; refreshed enabled assets */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        code: "SDK_WALLET_TRUSTLINE";
+                        /** @constant */
+                        success: true;
+                        content: {
+                            publicKey: string;
+                            /** @enum {string} */
+                            network: "testnet" | "mainnet";
+                            exists: boolean;
+                            assets: {
+                                /** @enum {string} */
+                                type: "native" | "credit_alphanum4" | "credit_alphanum12";
+                                code: string;
+                                issuer?: string;
+                                name?: string;
+                                trustlineEstablished: boolean;
+                                limit?: string;
+                                enabledInApp: boolean;
+                                sponsored?: boolean;
+                            }[];
+                        };
+                    };
+                };
+            };
+            /** @description Validation error */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        success: false;
+                        code: string;
+                    };
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        success: false;
+                        code: string;
+                    };
+                };
+            };
+            /** @description Not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @constant */
+                        success: false;
+                        code: string;
+                    };
+                };
+            };
+        };
+    };
     getWalletByPublicKeyBalance: {
         parameters: {
             query: {
@@ -5897,4 +6059,4 @@ declare function listDistributionRules(api: PollarApiClient): Promise<Distributi
  */
 declare function claimDistributionRule(api: PollarApiClient, body: DistributionClaimBody): Promise<DistributionClaimContent>;
 
-export { AUTH_ERROR_CODES, type AdapterFn, AlbedoAdapter, type AuthErrorCode, type AuthOpenContext, type AuthState, type AuthUrlOpener, type BuildOutcome, type BuildProofArgs, type ConnectWalletResponse, type DistributionClaimBody, type DistributionClaimContent, type DistributionRule, type DistributionRulesState, type EnabledAssetRecord, type EnabledAssetsState, FreighterAdapter, type KeyManager, type KycFlow, type KycLevel, type KycProvider, type KycStartBody, type KycStartResponse, type KycStatus, type LocalStorageAdapterOptions, type LogLevel, type NetworkState, OnStorageDegrade, POLLAR_CORE_VERSION, type PasskeyCeremony, type PasskeySigner, type PaymentInstructions, type PollarAdapter, type PollarAdapters, type PollarApiClient, type PollarApplicationConfigContent, type PollarApplicationConfigResponse, PollarClient, type PollarClientConfig, PollarFlowError, type PollarLogger, type PollarLoginOptions, type PollarPersistedSession, type PollarUserProfile, type PublicEcJwk, type RampDirection, type RampQuote, type RampTxStatus, type RampsOfframpBody, type RampsOfframpResponse, type RampsOnrampBody, type RampsOnrampResponse, type RampsQuoteQuery, type RampsQuoteResponse, type RampsTransactionResponse, type RulePeriod, type SessionInfo, type SessionsState, type SignAuthEntryOptions, type SignAuthEntryResponse, type SignOutcome, type SignTransactionOptions, type SignTransactionResponse, type StellarBalance, StellarClient, type StellarClientConfig, type StellarNetwork, Storage, type SubmitOutcome, type TransactionState, type TxBuildBody, type TxBuildContent, type TxBuildResponse, type TxBuildSignSubmitBody, type TxBuildSignSubmitContent, type TxBuildSignSubmitResponse, type TxErrorPhase, type TxHistoryContent, type TxHistoryParams, type TxHistoryRecord, type TxHistoryState, type TxSignAndSendBody, type TxSignBody, type TxSignContent, type TxSignResponse, type TxSignSendResponse, type TxSubmitSignedBody, type WalletAdapter, type WalletAdapterResolver, type WalletAssetsContent, type WalletBalanceContent, type WalletBalanceRecord, type WalletBalanceState, type WalletId, WalletType, WebCryptoKeyManager, buildProof, canonicalEcJwk, claimDistributionRule, computeJwkThumbprint, createLocalStorageAdapter, createLogger, createMemoryAdapter, createOffRamp, createOnRamp, defaultKeyManager, defaultStorage, getKycProviders, getKycStatus, getRampTransaction, getRampsQuote, isValidSession, listDistributionRules, normalizeHtu, pollKycStatus, pollRampTransaction, type paths as pollarPaths, resolveKyc, startKyc };
+export { AUTH_ERROR_CODES, type AdapterFn, AlbedoAdapter, type AuthErrorCode, type AuthOpenContext, type AuthState, type AuthUrlOpener, type BuildOutcome, type BuildProofArgs, type ConnectWalletResponse, type DistributionClaimBody, type DistributionClaimContent, type DistributionRule, type DistributionRulesState, type EnabledAssetRecord, type EnabledAssetsState, FreighterAdapter, type KeyManager, type KycFlow, type KycLevel, type KycProvider, type KycStartBody, type KycStartResponse, type KycStatus, type LocalStorageAdapterOptions, type LogLevel, type NetworkState, OnStorageDegrade, POLLAR_CORE_VERSION, type PasskeyCeremony, type PasskeyMode, type PasskeySigner, type PaymentInstructions, type PollarAdapter, type PollarAdapters, type PollarApiClient, type PollarApplicationConfigContent, type PollarApplicationConfigResponse, PollarClient, type PollarClientConfig, PollarFlowError, type PollarLogger, type PollarLoginOptions, type PollarPersistedSession, type PollarUserProfile, type PublicEcJwk, type RampDirection, type RampQuote, type RampTxStatus, type RampsOfframpBody, type RampsOfframpResponse, type RampsOnrampBody, type RampsOnrampResponse, type RampsQuoteQuery, type RampsQuoteResponse, type RampsTransactionResponse, type RulePeriod, type SessionInfo, type SessionsState, type SignAuthEntryOptions, type SignAuthEntryResponse, type SignOutcome, type SignTransactionOptions, type SignTransactionResponse, type StellarBalance, StellarClient, type StellarClientConfig, type StellarNetwork, Storage, type SubmitOutcome, type TransactionState, type TrustlineOutcome, type TxBuildBody, type TxBuildContent, type TxBuildResponse, type TxBuildSignSubmitBody, type TxBuildSignSubmitContent, type TxBuildSignSubmitResponse, type TxErrorPhase, type TxHistoryContent, type TxHistoryParams, type TxHistoryRecord, type TxHistoryState, type TxSignAndSendBody, type TxSignBody, type TxSignContent, type TxSignResponse, type TxSignSendResponse, type TxSubmitSignedBody, type WalletAdapter, type WalletAdapterResolver, type WalletAssetsContent, type WalletBalanceContent, type WalletBalanceRecord, type WalletBalanceState, type WalletId, WalletType, WebCryptoKeyManager, buildProof, canonicalEcJwk, claimDistributionRule, computeJwkThumbprint, createLocalStorageAdapter, createLogger, createMemoryAdapter, createOffRamp, createOnRamp, defaultKeyManager, defaultStorage, getKycProviders, getKycStatus, getRampTransaction, getRampsQuote, isValidSession, listDistributionRules, normalizeHtu, pollKycStatus, pollRampTransaction, type paths as pollarPaths, resolveKyc, startKyc };

package/dist/index.js

@@ -1173,7 +1173,7 @@ function defaultStorage(options = {}) {
 }
 
 // src/version.ts
-var POLLAR_CORE_VERSION = "0.9.0-rc.2" ;
+var POLLAR_CORE_VERSION = "0.9.0-rc.3" ;
 
 // src/visibility/noop.ts
 function createNoopVisibilityProvider() {
@@ -1894,7 +1894,7 @@ async function loginOAuth(provider, deps) {
 }
 
 // src/client/auth/passkeyFlow.ts
-async function loginSmartWallet(deps) {
+async function smartWalletFlow(deps, mode) {
   const { api, signal, setAuthState, passkey } = deps;
   if (!passkey) {
     setAuthState({
@@ -1917,7 +1917,7 @@ async function loginSmartWallet(deps) {
       return failPasskey(setAuthState, "Failed to start passkey");
     }
     setAuthState({ step: "creating_passkey" });
-    const ceremony = await passkey({ challenge });
+    const ceremony = await passkey({ challenge, mode });
     const response = ceremony.response;
     if (ceremony.kind === "register") {
       setAuthState({ step: "deploying_smart_account" });
@@ -2510,9 +2510,10 @@ var PollarClient = class {
     loginWallet(type, this._flowDeps(controller.signal)).catch((err) => this._handleFlowError(err));
   }
   /**
-   * "Smart Wallet" login: runs the passkey (WebAuthn) ceremony and, for a new
-   * user, creates a sponsored smart-account C-address. Requires the `passkey`
-   * ceremony to be configured (e.g. via `@pollar/react`).
+   * "Smart Wallet" login: runs the passkey (WebAuthn) `get()` ceremony for a
+   * returning user and signs them in. Use {@link createSmartWallet} for a new
+   * user. Requires the `passkey` ceremony to be configured (e.g. via
+   * `@pollar/react`).
    */
   loginSmartWallet() {
     if (!isClientRuntime) {
@@ -2520,7 +2521,21 @@ var PollarClient = class {
       return;
     }
     const controller = this._newController();
-    loginSmartWallet(this._flowDeps(controller.signal)).catch((err) => this._handleFlowError(err));
+    smartWalletFlow(this._flowDeps(controller.signal), "login").catch((err) => this._handleFlowError(err));
+  }
+  /**
+   * "Smart Wallet" registration: runs the passkey (WebAuthn) `create()` ceremony
+   * for a new user and deploys a sponsored smart-account C-address. Use
+   * {@link loginSmartWallet} for a returning user. Requires the `passkey`
+   * ceremony to be configured (e.g. via `@pollar/react`).
+   */
+  createSmartWallet() {
+    if (!isClientRuntime) {
+      warnServerSide("createSmartWallet");
+      return;
+    }
+    const controller = this._newController();
+    smartWalletFlow(this._flowDeps(controller.signal), "register").catch((err) => this._handleFlowError(err));
   }
   // ─── Cancel ───────────────────────────────────────────────────────────────
   cancelLogin() {
@@ -2760,6 +2775,54 @@ var PollarClient = class {
       this._setEnabledAssetsState({ step: "error", message: "Failed to load assets" });
     }
   }
+  /**
+   * Establishes (omit `limit`) or removes (`limit: '0'`) a trustline for an asset.
+   *
+   * Routing mirrors how the platform pays for the reserve:
+   *  - **Sponsored custodial** (`opts.sponsored` true, internal wallet) → the
+   *    server orchestrates a sponsored `changeTrust`: the app's wallets cover the
+   *    0.5 XLM reserve and the fee, so the user pays nothing. Pass the asset's
+   *    `sponsored` flag (from {@link refreshAssets}) straight through.
+   *  - **Self-paid** (external/adapter wallet, sponsorship disabled, or a custom
+   *    asset not configured in the app) → a plain `change_trust` transaction the
+   *    user's own wallet signs and pays for, via {@link runTx}.
+   *
+   * Does not refresh on its own — callers should `refreshAssets()` afterwards.
+   */
+  async setTrustline(asset, opts) {
+    const limit = opts?.limit;
+    const walletType = this._session?.wallet?.type;
+    if (!this._session?.wallet?.address) {
+      return { status: "error", details: "No wallet connected" };
+    }
+    if (walletType === "smart") {
+      return { status: "error", details: "Trustlines do not apply to smart wallets" };
+    }
+    if (opts?.sponsored && !this._walletAdapter && walletType === "internal") {
+      try {
+        const { data, error } = await this._api.POST("/wallet/assets/trustline", {
+          body: { code: asset.code, issuer: asset.issuer, ...limit !== void 0 && { limit } }
+        });
+        if (!error && data?.success) {
+          if (data.content) this._setEnabledAssetsState({ step: "loaded", data: data.content });
+          return { status: "success" };
+        }
+        const details = error?.details ?? error?.code;
+        return { status: "error", ...details && { details } };
+      } catch (err) {
+        const details = err instanceof Error ? err.message : void 0;
+        return { status: "error", ...details && { details } };
+      }
+    }
+    return this.runTx("change_trust", {
+      asset: {
+        type: asset.code.length <= 4 ? "credit_alphanum4" : "credit_alphanum12",
+        code: asset.code,
+        issuer: asset.issuer
+      },
+      ...limit !== void 0 && { limit }
+    });
+  }
   // ─── Transactions ─────────────────────────────────────────────────────────
   /**
    * Builds an unsigned XDR. Drives `_setTransactionState` for modal-style UIs