@coinlist-co/react 0.12.2-rc.7b430dd → 0.12.2-rc.8a0d02a

package/dist/{token-registry-snapshot-BNBNuDu1.d.ts → token-registry-snapshot-BkwA8KmD.d.ts}

@@ -1,4 +1,4 @@
-import { aI as ClientId, bw as RedirectUri, aJ as CodeChallenge, bk as PKCEState, C as CodeVerifier, q as EvmWalletAddress, a as EthereumChain, bN as Tx, B as BlockchainAmount, bG as SwapPreview, a0 as AssetDecimals, aA as Newtype, D as TokenMetadata, aH as Chain, b as EvmContractAddress, bf as OfferToken } from './tokens-namespace-CIWBtgt2.js';
+import { b5 as ClientId, bX as RedirectUri, b6 as CodeChallenge, bL as PKCEState, C as CodeVerifier, v as EvmWalletAddress, a as EthereumChain, cc as Tx, B as BlockchainAmount, c5 as SwapPreview, a9 as AssetDecimals, aQ as Newtype, J as TokenMetadata, b4 as Chain, b as EvmContractAddress, aL as OfferToken } from './time-CVZpAkGY.js';
 import { Hex, Abi, Hash, TransactionReceipt } from 'viem';
 
 type PKCEParams = {
@@ -70,6 +70,30 @@ interface EvmWallet extends EvmSigner {
 type ConnectWallet = EvmSigner & {
     readonly chain: EthereumChain;
 };
+/**
+ * The host's connector for an external wallet, as two lambdas: one opens it,
+ * one tears the connection down. The SDK ships no wallet stack, so this is how
+ * a screen offers "Connect wallet" without knowing whether AppKit, Privy or the
+ * host's own modal is behind it.
+ *
+ * One product type rather than two optional lambdas, because they come as a
+ * pair: a screen that can connect a wallet must be able to let it go again,
+ * and a host that supports neither passes `null` for the whole adapter, which
+ * hides the connect affordance entirely.
+ */
+type ExternalWalletAdapter = {
+    /**
+     * Opens the host's wallet connector. Resolves once the attempt finishes; the
+     * SDK reads the outcome from the external wallet it is handed on the next
+     * render rather than from a return value, so a host that connects through a
+     * redirect still works.
+     *
+     * Rejecting is how a declined or failed connection is reported.
+     */
+    connect: () => Promise<void>;
+    /** Disconnects the external wallet. Resolves when it is gone. */
+    disconnect: () => Promise<void>;
+};
 
 /**
  * A read-only quote for a swap as domain amounts: how much goes in, the
@@ -107,6 +131,46 @@ declare const FormattedAmountAssetUi: (value: string) => FormattedAmountAssetUi;
 type AssetIconUrl = Newtype<string, 'AssetIconUrl'>;
 declare const AssetIconUrl: (value: string) => AssetIconUrl;
 
+/**
+ * The wallets a screen reads for and acts from, supplied by the host.
+ *
+ * The SDK ships no wallet stack, so wallet discovery and connection are
+ * inverted onto the host: it hands over ready {@link EvmWallet}s, and an
+ * adapter for connecting an external one when it supports that. Every wallet
+ * here is one that can sign for itself, so a screen can broadcast from the
+ * wallet that holds a position.
+ */
+type WalletSelection = {
+    /**
+     * The user's embedded (custodial) wallets, in display order. Empty when
+     * they have none, which is a normal state, not an error.
+     */
+    embedded: EvmWallet[];
+    /** The connected external wallet, or `null` while none is connected. */
+    external: EvmWallet | null;
+    /**
+     * The host's external-wallet connector, or `null` when it offers none - in
+     * which case the screen shows no connect affordance at all. A host may
+     * still pass a connected `external` without one, to show a wallet the user
+     * cannot change from here.
+     */
+    externalAdapter: ExternalWalletAdapter | null;
+};
+declare const WalletSelection: {
+    /**
+     * Every wallet in display order - embedded first, then the external one -
+     * each address once. Addresses compare case-insensitively, so a host that
+     * hands the same wallet over as both embedded and external sees it once.
+     */
+    all: (selection: WalletSelection) => EvmWallet[];
+};
+/**
+ * Names a wallet for display, e.g. `'CoinList Wallet'` for the user's
+ * embedded one. `null` means it has no name, and the screen shows its
+ * shortened address instead.
+ */
+type WalletLabelResolver = (address: EvmWalletAddress) => string | null;
+
 /**
  * An array guaranteed to hold at least one element. Use it where an empty list
  * would be a bug (e.g. the set of assets a swap always offers).
@@ -162,13 +226,15 @@ declare const TokenRegistrySnapshot: {
     }) => TokenMetadata | null;
 };
 /**
- * The tokens an offer is *about*, most specific first: every `swap` entry,
- * then every `distribution` entry. `funding` entries name what a swap is paid
- * with (USDC, USDT) and never the asset on offer, so they are left out.
+ * The tokens an offer is *about*, most specific first: every `swap` or
+ * `vault` entry, then every `distribution` entry. `funding` entries name what
+ * an offer is paid with (USDC, USDT) and never the asset on offer, so they are
+ * left out.
  *
- * `swap` outranks `distribution` because a swap product names the asset it
- * hands over precisely, while a sale's distribution entry names the same
- * token for a sale product and is accepted as the fallback. The checkout's
+ * `swap` and `vault` rank together - no offer type carries both - and outrank
+ * `distribution` because a swap or vault product names the token it hands over
+ * precisely, while a sale's distribution entry names the same token for a sale
+ * product and is accepted as the fallback. The checkout's
  * per-chain lookup and the catalogue's any-chain lookup both read this
  * ordering, which is why it is stated once, here.
  */
@@ -176,4 +242,4 @@ declare function offerDisplayTokens(offer: {
     tokens: readonly OfferToken[];
 }): OfferToken[];
 
-export { AssetIconUrl as A, type BroadcastTxParams as B, type ConnectWallet as C, type EvmWallet as E, FormattedAmountAssetUi as F, type NonEmptyArray as N, type PKCEConfig as P, SwapQuote as S, TxExplorerUrl as T, type WriteContractParams as W, ShortenedWalletAddress as a, FormattedPercentUi as b, TokenRegistrySnapshot as c, type EvmSigner as d, FormattedAmountUi as e, type PKCEParams as f, generatePKCEParams as g, offerDisplayTokens as o };
+export { AssetIconUrl as A, type BroadcastTxParams as B, type ConnectWallet as C, type EvmWallet as E, FormattedAmountAssetUi as F, type NonEmptyArray as N, type PKCEConfig as P, SwapQuote as S, TxExplorerUrl as T, WalletSelection as W, ShortenedWalletAddress as a, FormattedPercentUi as b, type WalletLabelResolver as c, TokenRegistrySnapshot as d, type EvmSigner as e, type ExternalWalletAdapter as f, type WriteContractParams as g, FormattedAmountUi as h, type PKCEParams as i, generatePKCEParams as j, offerDisplayTokens as o };

package/dist/{token-registry-snapshot-CqI6dXM_.d.cts → token-registry-snapshot-bR14QehS.d.cts}

@@ -1,4 +1,4 @@
-import { aI as ClientId, bw as RedirectUri, aJ as CodeChallenge, bk as PKCEState, C as CodeVerifier, q as EvmWalletAddress, a as EthereumChain, bN as Tx, B as BlockchainAmount, bG as SwapPreview, a0 as AssetDecimals, aA as Newtype, D as TokenMetadata, aH as Chain, b as EvmContractAddress, bf as OfferToken } from './tokens-namespace-CIWBtgt2.cjs';
+import { b5 as ClientId, bX as RedirectUri, b6 as CodeChallenge, bL as PKCEState, C as CodeVerifier, v as EvmWalletAddress, a as EthereumChain, cc as Tx, B as BlockchainAmount, c5 as SwapPreview, a9 as AssetDecimals, aQ as Newtype, J as TokenMetadata, b4 as Chain, b as EvmContractAddress, aL as OfferToken } from './time-CVZpAkGY.cjs';
 import { Hex, Abi, Hash, TransactionReceipt } from 'viem';
 
 type PKCEParams = {
@@ -70,6 +70,30 @@ interface EvmWallet extends EvmSigner {
 type ConnectWallet = EvmSigner & {
     readonly chain: EthereumChain;
 };
+/**
+ * The host's connector for an external wallet, as two lambdas: one opens it,
+ * one tears the connection down. The SDK ships no wallet stack, so this is how
+ * a screen offers "Connect wallet" without knowing whether AppKit, Privy or the
+ * host's own modal is behind it.
+ *
+ * One product type rather than two optional lambdas, because they come as a
+ * pair: a screen that can connect a wallet must be able to let it go again,
+ * and a host that supports neither passes `null` for the whole adapter, which
+ * hides the connect affordance entirely.
+ */
+type ExternalWalletAdapter = {
+    /**
+     * Opens the host's wallet connector. Resolves once the attempt finishes; the
+     * SDK reads the outcome from the external wallet it is handed on the next
+     * render rather than from a return value, so a host that connects through a
+     * redirect still works.
+     *
+     * Rejecting is how a declined or failed connection is reported.
+     */
+    connect: () => Promise<void>;
+    /** Disconnects the external wallet. Resolves when it is gone. */
+    disconnect: () => Promise<void>;
+};
 
 /**
  * A read-only quote for a swap as domain amounts: how much goes in, the
@@ -107,6 +131,46 @@ declare const FormattedAmountAssetUi: (value: string) => FormattedAmountAssetUi;
 type AssetIconUrl = Newtype<string, 'AssetIconUrl'>;
 declare const AssetIconUrl: (value: string) => AssetIconUrl;
 
+/**
+ * The wallets a screen reads for and acts from, supplied by the host.
+ *
+ * The SDK ships no wallet stack, so wallet discovery and connection are
+ * inverted onto the host: it hands over ready {@link EvmWallet}s, and an
+ * adapter for connecting an external one when it supports that. Every wallet
+ * here is one that can sign for itself, so a screen can broadcast from the
+ * wallet that holds a position.
+ */
+type WalletSelection = {
+    /**
+     * The user's embedded (custodial) wallets, in display order. Empty when
+     * they have none, which is a normal state, not an error.
+     */
+    embedded: EvmWallet[];
+    /** The connected external wallet, or `null` while none is connected. */
+    external: EvmWallet | null;
+    /**
+     * The host's external-wallet connector, or `null` when it offers none - in
+     * which case the screen shows no connect affordance at all. A host may
+     * still pass a connected `external` without one, to show a wallet the user
+     * cannot change from here.
+     */
+    externalAdapter: ExternalWalletAdapter | null;
+};
+declare const WalletSelection: {
+    /**
+     * Every wallet in display order - embedded first, then the external one -
+     * each address once. Addresses compare case-insensitively, so a host that
+     * hands the same wallet over as both embedded and external sees it once.
+     */
+    all: (selection: WalletSelection) => EvmWallet[];
+};
+/**
+ * Names a wallet for display, e.g. `'CoinList Wallet'` for the user's
+ * embedded one. `null` means it has no name, and the screen shows its
+ * shortened address instead.
+ */
+type WalletLabelResolver = (address: EvmWalletAddress) => string | null;
+
 /**
  * An array guaranteed to hold at least one element. Use it where an empty list
  * would be a bug (e.g. the set of assets a swap always offers).
@@ -162,13 +226,15 @@ declare const TokenRegistrySnapshot: {
     }) => TokenMetadata | null;
 };
 /**
- * The tokens an offer is *about*, most specific first: every `swap` entry,
- * then every `distribution` entry. `funding` entries name what a swap is paid
- * with (USDC, USDT) and never the asset on offer, so they are left out.
+ * The tokens an offer is *about*, most specific first: every `swap` or
+ * `vault` entry, then every `distribution` entry. `funding` entries name what
+ * an offer is paid with (USDC, USDT) and never the asset on offer, so they are
+ * left out.
  *
- * `swap` outranks `distribution` because a swap product names the asset it
- * hands over precisely, while a sale's distribution entry names the same
- * token for a sale product and is accepted as the fallback. The checkout's
+ * `swap` and `vault` rank together - no offer type carries both - and outrank
+ * `distribution` because a swap or vault product names the token it hands over
+ * precisely, while a sale's distribution entry names the same token for a sale
+ * product and is accepted as the fallback. The checkout's
  * per-chain lookup and the catalogue's any-chain lookup both read this
  * ordering, which is why it is stated once, here.
  */
@@ -176,4 +242,4 @@ declare function offerDisplayTokens(offer: {
     tokens: readonly OfferToken[];
 }): OfferToken[];
 
-export { AssetIconUrl as A, type BroadcastTxParams as B, type ConnectWallet as C, type EvmWallet as E, FormattedAmountAssetUi as F, type NonEmptyArray as N, type PKCEConfig as P, SwapQuote as S, TxExplorerUrl as T, type WriteContractParams as W, ShortenedWalletAddress as a, FormattedPercentUi as b, TokenRegistrySnapshot as c, type EvmSigner as d, FormattedAmountUi as e, type PKCEParams as f, generatePKCEParams as g, offerDisplayTokens as o };
+export { AssetIconUrl as A, type BroadcastTxParams as B, type ConnectWallet as C, type EvmWallet as E, FormattedAmountAssetUi as F, type NonEmptyArray as N, type PKCEConfig as P, SwapQuote as S, TxExplorerUrl as T, WalletSelection as W, ShortenedWalletAddress as a, FormattedPercentUi as b, type WalletLabelResolver as c, TokenRegistrySnapshot as d, type EvmSigner as e, type ExternalWalletAdapter as f, type WriteContractParams as g, FormattedAmountUi as h, type PKCEParams as i, generatePKCEParams as j, offerDisplayTokens as o };