@reclack/walletkit 0.0.0-stage → 0.1.0

package/custom-elements.json

@@ -0,0 +1,207 @@
+{
+	"schemaVersion": "2.1.0",
+	"readme": "README.md",
+	"modules": [
+		{
+			"kind": "javascript-module",
+			"path": "dist/element.js",
+			"declarations": [
+				{
+					"kind": "class",
+					"name": "ReclackConnectElement",
+					"tagName": "reclack-connect",
+					"customElement": true,
+					"description": "Connect a wallet, read an address, read a balance.",
+					"attributes": [
+						{
+							"name": "variant",
+							"type": {
+								"text": "'inline' | 'modal'"
+							},
+							"description": "Where the picker sits: a list on the page, or the whole picker over it."
+						},
+						{
+							"name": "family",
+							"type": {
+								"text": "'evm' | 'svm'"
+							},
+							"description": "Restricts the list to one chain family. Both when absent."
+						},
+						{
+							"name": "chain-id",
+							"type": {
+								"text": "number"
+							},
+							"description": "The EVM chain the wallet must end up on. No switch is forced without it."
+						},
+						{
+							"name": "intent",
+							"type": {
+								"text": "string"
+							},
+							"description": "Comma separated: address, balance."
+						},
+						{
+							"name": "keep-alive",
+							"type": {
+								"text": "boolean"
+							},
+							"description": "Hold the connection open afterwards, for a page that signs later."
+						},
+						{
+							"name": "theme-mode",
+							"type": {
+								"text": "'light' | 'dark' | 'system'"
+							},
+							"description": "Light, dark, or whatever the reader\u2019s system says."
+						},
+						{
+							"name": "brand",
+							"type": {
+								"text": "string"
+							},
+							"description": "#rrggbb. Anything else is ignored and the default stands."
+						},
+						{
+							"name": "radius",
+							"type": {
+								"text": "string"
+							},
+							"description": "Corner radius, as a CSS length."
+						},
+						{
+							"name": "font",
+							"type": {
+								"text": "string"
+							},
+							"description": "The host\u2019s type, so the picker does not arrive in a different face."
+						},
+						{
+							"name": "asset-base",
+							"type": {
+								"text": "string"
+							},
+							"description": "Where the host serves this package's assets/ directory from."
+						},
+						{
+							"name": "api-url",
+							"type": {
+								"text": "string"
+							},
+							"description": "A different Reclack to read the wallet catalogue from, such as a sandbox."
+						}
+					],
+					"members": [
+						{
+							"kind": "field",
+							"name": "kit",
+							"type": {
+								"text": "WalletKit"
+							},
+							"description": "A kit to share rather than one this element would make for itself."
+						},
+						{
+							"kind": "field",
+							"name": "request",
+							"type": {
+								"text": "ConnectRequest"
+							},
+							"description": "The whole request, for an intent carrying assets."
+						},
+						{
+							"kind": "field",
+							"name": "theme",
+							"type": {
+								"text": "WalletKitTheme"
+							},
+							"description": "The whole theme, for per-mode overrides."
+						}
+					],
+					"events": [
+						{
+							"name": "connect",
+							"type": {
+								"text": "CustomEvent<ConnectResult>"
+							},
+							"description": "A wallet was connected and the intent resolved."
+						},
+						{
+							"name": "cancel",
+							"type": {
+								"text": "CustomEvent"
+							},
+							"description": "The picker was closed without connecting."
+						},
+						{
+							"name": "connect-error",
+							"type": {
+								"text": "CustomEvent<{ message: string }>"
+							},
+							"description": "Something refused. Named connect-error because every element already has an error event for a resource that failed to load."
+						}
+					],
+					"cssProperties": [
+						{
+							"name": "--rkw-surface",
+							"description": "The panel itself."
+						},
+						{
+							"name": "--rkw-ground",
+							"description": "Behind the panel."
+						},
+						{
+							"name": "--rkw-plate",
+							"description": "Rows and plates inside it."
+						},
+						{
+							"name": "--rkw-ink",
+							"description": "Primary text."
+						},
+						{
+							"name": "--rkw-ink-muted",
+							"description": "Secondary text."
+						},
+						{
+							"name": "--rkw-line",
+							"description": "Hairlines and borders."
+						},
+						{
+							"name": "--rkw-brand",
+							"description": "The primary action and the focus ring."
+						},
+						{
+							"name": "--rkw-brand-ink",
+							"description": "Text on the brand colour. Computed when not set."
+						},
+						{
+							"name": "--rkw-danger",
+							"description": "A refusal."
+						},
+						{
+							"name": "--rkw-ok",
+							"description": "A success."
+						},
+						{
+							"name": "--rkw-radius",
+							"description": "Corner radius."
+						},
+						{
+							"name": "--rkw-font",
+							"description": "Type face."
+						}
+					]
+				}
+			],
+			"exports": [
+				{
+					"kind": "custom-element-definition",
+					"name": "reclack-connect",
+					"declaration": {
+						"name": "ReclackConnectElement",
+						"module": "dist/element.js"
+					}
+				}
+			]
+		}
+	]
+}

package/dist/abi.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The smallest ABI encoder that can authorize a subscription.
+ *
+ * No wallet SDK and no keccak implementation ship in this bundle. Every call
+ * this page makes has a fixed signature, so the four-byte selectors are
+ * constants: computed once with `cast sig` and pinned below, and every
+ * argument is a static 32-byte word. That makes the encoder a few lines of
+ * string work instead of a dependency on a checkout page that handles money.
+ *
+ * Regenerate a selector with:
+ *   cast sig "approve(address,uint256)"
+ * The unit test in abi.test.ts asserts these against the same signatures.
+ */
+/** Left-pads a hex value to one 32-byte ABI word. */
+export declare function word(value: bigint | string): string;
+/** Encodes an address as a left-padded word, rejecting anything malformed. */
+export declare function addressWord(address: string): string;
+/** A bytes32 value, right-padded: the one argument that is not left-aligned. */
+export declare function bytes32(hex: string): string;
+/** Concatenates a selector and its already-encoded words into calldata. */
+export declare function calldata(selector: string, words: string[]): string;

package/dist/abi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abi.d.ts","sourceRoot":"","sources":["../src/abi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,qDAAqD;AACrD,wBAAgB,IAAI,CAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAcpD;AAED,8EAA8E;AAC9E,wBAAgB,WAAW,CAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAKpD;AAED,gFAAgF;AAChF,wBAAgB,OAAO,CAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAM5C;AAED,2EAA2E;AAC3E,wBAAgB,QAAQ,CAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAEnE"}

package/dist/abi.js

@@ -0,0 +1,50 @@
+/**
+ * The smallest ABI encoder that can authorize a subscription.
+ *
+ * No wallet SDK and no keccak implementation ship in this bundle. Every call
+ * this page makes has a fixed signature, so the four-byte selectors are
+ * constants: computed once with `cast sig` and pinned below, and every
+ * argument is a static 32-byte word. That makes the encoder a few lines of
+ * string work instead of a dependency on a checkout page that handles money.
+ *
+ * Regenerate a selector with:
+ *   cast sig "approve(address,uint256)"
+ * The unit test in abi.test.ts asserts these against the same signatures.
+ */
+/** Left-pads a hex value to one 32-byte ABI word. */
+export function word(value) {
+    let hex;
+    if (typeof value === 'bigint') {
+        if (value < 0n) {
+            throw new Error('negative values are not encodable here');
+        }
+        hex = value.toString(16);
+    }
+    else {
+        hex = value.toLowerCase().replace(/^0x/, '');
+    }
+    if (hex.length > 64) {
+        throw new Error('value does not fit in a 32-byte word');
+    }
+    return hex.padStart(64, '0');
+}
+/** Encodes an address as a left-padded word, rejecting anything malformed. */
+export function addressWord(address) {
+    if (!/^0x[0-9a-fA-F]{40}$/.test(address)) {
+        throw new Error('invalid address');
+    }
+    return word(address);
+}
+/** A bytes32 value, right-padded: the one argument that is not left-aligned. */
+export function bytes32(hex) {
+    const raw = hex.toLowerCase().replace(/^0x/, '');
+    if (raw.length > 64 || /[^0-9a-f]/.test(raw)) {
+        throw new Error('invalid bytes32');
+    }
+    return raw.padEnd(64, '0');
+}
+/** Concatenates a selector and its already-encoded words into calldata. */
+export function calldata(selector, words) {
+    return selector + words.join('');
+}
+//# sourceMappingURL=abi.js.map

package/dist/abi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abi.js","sourceRoot":"","sources":["../src/abi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,qDAAqD;AACrD,MAAM,UAAU,IAAI,CAAE,KAAsB;IAC3C,IAAI,GAAW,CAAA;IACf,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC/B,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAA;QAC1D,CAAC;QACD,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;IACzB,CAAC;SAAM,CAAC;QACP,GAAG,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;IAC7C,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAA;IACxD,CAAC;IACD,OAAO,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAA;AAC7B,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,WAAW,CAAE,OAAe;IAC3C,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAA;IACnC,CAAC;IACD,OAAO,IAAI,CAAC,OAAO,CAAC,CAAA;AACrB,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,OAAO,CAAE,GAAW;IACnC,MAAM,GAAG,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;IAChD,IAAI,GAAG,CAAC,MAAM,GAAG,EAAE,IAAI,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAA;IACnC,CAAC;IACD,OAAO,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,CAAA;AAC3B,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,QAAQ,CAAE,QAAgB,EAAE,KAAe;IAC1D,OAAO,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;AACjC,CAAC"}

package/dist/address.d.ts

@@ -0,0 +1,15 @@
+/**
+ * An address, shortened the way addresses are shortened.
+ *
+ * Head and tail, not a card-style mask: an address is not a secret to be
+ * redacted, it is a public identifier that is merely too long for the place
+ * it has to fit. Both ends carry meaning: the prefix says which chain family
+ * it belongs to, and the tail is what somebody quotes when asking about a
+ * payment.
+ *
+ * One function for every surface, because the same wallet should read the
+ * same wherever it appears. This used to be written out separately in the
+ * checkout and in the dashboard, each with a comment saying it matched the
+ * other.
+ */
+export declare function shortAddress(address: string | undefined): string | undefined;

package/dist/address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../src/address.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAS7E"}

package/dist/address.js

@@ -0,0 +1,25 @@
+/**
+ * An address, shortened the way addresses are shortened.
+ *
+ * Head and tail, not a card-style mask: an address is not a secret to be
+ * redacted, it is a public identifier that is merely too long for the place
+ * it has to fit. Both ends carry meaning: the prefix says which chain family
+ * it belongs to, and the tail is what somebody quotes when asking about a
+ * payment.
+ *
+ * One function for every surface, because the same wallet should read the
+ * same wherever it appears. This used to be written out separately in the
+ * checkout and in the dashboard, each with a comment saying it matched the
+ * other.
+ */
+export function shortAddress(address) {
+    const value = address?.trim();
+    if (!value) {
+        return undefined;
+    }
+    if (value.length < 12) {
+        return value;
+    }
+    return `${value.slice(0, 6)}…${value.slice(-4)}`;
+}
+//# sourceMappingURL=address.js.map

package/dist/address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.js","sourceRoot":"","sources":["../src/address.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,YAAY,CAAE,OAA2B;IACxD,MAAM,KAAK,GAAG,OAAO,EAAE,IAAI,EAAE,CAAA;IAC7B,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,OAAO,SAAS,CAAA;IACjB,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACvB,OAAO,KAAK,CAAA;IACb,CAAC;IACD,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;AACjD,CAAC"}

package/dist/balance.d.ts

@@ -0,0 +1,78 @@
+import type { Eip1193Provider } from './types.js';
+/**
+ * What a balance is a balance of.
+ *
+ * Omitting the contract means the chain's own coin, which is a real question
+ * and not an edge case: the authorization path is relayed and needs no gas,
+ * but the approve and transfer paths do, and "no ETH" is the failure a token
+ * balance does not catch.
+ */
+export type Asset = {
+    family: 'evm';
+    chainId: number;
+    /** ERC-20 contract. Absent for the chain's native coin. */
+    token?: string;
+    decimals?: number;
+    symbol?: string;
+} | {
+    family: 'svm';
+    /** SPL mint. Absent for SOL itself. */
+    mint?: string;
+    decimals?: number;
+    symbol?: string;
+};
+/**
+ * An amount, in the asset's smallest unit.
+ *
+ * A bigint, never a number. Money does not survive a float: 0.1 + 0.2 is not
+ * 0.3 in binary, and a balance compared against a charge decides whether
+ * somebody is asked to sign something that cannot settle.
+ */
+export interface Balance {
+    asset: Asset;
+    amount: bigint;
+    decimals: number;
+    symbol?: string;
+}
+/**
+ * Where a balance is read from, and the choice matters more than it looks.
+ *
+ * Through the connected wallet's own provider, the wallet has to be on that
+ * chain, so asking for a balance forces a network switch. Through an RPC
+ * endpoint it does not, and several chains can be read at once. So the RPC is
+ * the default for anything informational, and the provider is for the one
+ * case that needs it: the pre-flight immediately before signing, where the
+ * question is what this exact wallet can spend right now.
+ */
+export type BalanceSource = {
+    provider: Eip1193Provider;
+} | {
+    rpcUrl: string;
+};
+/** The payer's balance of one EVM asset. */
+export declare function readEvmBalance(source: BalanceSource, asset: Extract<Asset, {
+    family: 'evm';
+}>, owner: string): Promise<Balance>;
+/**
+ * The payer's balance of one Solana asset.
+ *
+ * RPC only. Solana wallets sign; they do not answer questions about the
+ * chain, so there is no provider path here the way there is on EVM.
+ *
+ * Token accounts are listed by mint rather than deriving the associated
+ * account address, which would mean shipping a program-derived-address
+ * implementation to answer a question the node can answer directly. An owner
+ * may hold several accounts for one mint, so they are summed.
+ */
+export declare function readSvmBalance(rpcUrl: string, asset: Extract<Asset, {
+    family: 'svm';
+}>, owner: string): Promise<Balance>;
+/**
+ * Formats an amount for display, without ever making it a float.
+ *
+ * String arithmetic on the integer, not a division: the whole reason the
+ * amount is a bigint is that the moment it becomes a Number it stops being
+ * exact, and a balance is shown next to a charge the payer is about to
+ * approve.
+ */
+export declare function formatUnits(amount: bigint, decimals: number): string;

package/dist/balance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"balance.d.ts","sourceRoot":"","sources":["../src/balance.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD;;;;;;;GAOG;AACH,MAAM,MAAM,KAAK,GACd;IACD,MAAM,EAAE,KAAK,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;CACf,GACC;IACD,MAAM,EAAE,KAAK,CAAA;IACb,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,OAAO;IACvB,KAAK,EAAE,KAAK,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,aAAa,GACtB;IAAE,QAAQ,EAAE,eAAe,CAAA;CAAE,GAC7B;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AA+ErB,4CAA4C;AAC5C,wBAAsB,cAAc,CACnC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE;IAAE,MAAM,EAAE,KAAK,CAAA;CAAE,CAAC,EACxC,KAAK,EAAE,MAAM,GACX,OAAO,CAAC,OAAO,CAAC,CA0BlB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CACnC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE;IAAE,MAAM,EAAE,KAAK,CAAA;CAAE,CAAC,EACxC,KAAK,EAAE,MAAM,GACX,OAAO,CAAC,OAAO,CAAC,CA+BlB;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CASrE"}

package/dist/balance.js

@@ -0,0 +1,146 @@
+import { addressWord, calldata } from './abi.js';
+import { chainMetadata } from './chains.js';
+// cast sig "balanceOf(address)"
+const BALANCE_OF_SELECTOR = '0x70a08231';
+// cast sig "decimals()"
+const DECIMALS_SELECTOR = '0x313ce567';
+/** Lamports per SOL, and the decimals every SOL balance is quoted in. */
+const SOL_DECIMALS = 9;
+function hexToBigInt(raw) {
+    return typeof raw === 'string' && raw !== '0x' ? BigInt(raw) : 0n;
+}
+/**
+ * One JSON-RPC call over HTTP.
+ *
+ * Hand-rolled rather than pulled from a client library, for the same reason
+ * the ABI encoder is: this package runs on pages that handle other people's
+ * money, and every dependency is code somebody else can change under us.
+ */
+async function rpc(url, method, params) {
+    const response = await fetch(url, {
+        method: 'POST',
+        credentials: 'omit',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ jsonrpc: '2.0', id: 1, method, params }),
+    });
+    if (!response.ok) {
+        throw new Error(`RPC ${method} failed: ${response.status}`);
+    }
+    const body = (await response.json());
+    if (body.error) {
+        throw new Error(body.error.message ?? `RPC ${method} failed`);
+    }
+    return body.result;
+}
+/** An eth_call, through whichever source was given. */
+async function call(source, to, data) {
+    const params = [{ to, data }, 'latest'];
+    return 'provider' in source
+        ? source.provider.request({ method: 'eth_call', params })
+        : rpc(source.rpcUrl, 'eth_call', params);
+}
+/**
+ * How many decimals the token quotes, asked of the token itself.
+ *
+ * Only when the caller did not say. A caller that knows should pass it: USDC
+ * is six everywhere it matters, and a round trip to find that out again is a
+ * round trip.
+ */
+async function evmDecimals(source, token, given) {
+    if (typeof given === 'number') {
+        return given;
+    }
+    const raw = await call(source, token, calldata(DECIMALS_SELECTOR, []));
+    const value = Number(hexToBigInt(raw));
+    // A token that answers something absurd is a token this is not going to
+    // get right by guessing. Eighteen is the ERC-20 default.
+    return Number.isInteger(value) && value >= 0 && value <= 36 ? value : 18;
+}
+/** The payer's balance of one EVM asset. */
+export async function readEvmBalance(source, asset, owner) {
+    if (!asset.token) {
+        const params = [owner, 'latest'];
+        const raw = 'provider' in source
+            ? await source.provider.request({ method: 'eth_getBalance', params })
+            : await rpc(source.rpcUrl, 'eth_getBalance', params);
+        const native = chainMetadata(asset.chainId)?.nativeCurrency;
+        return {
+            asset,
+            amount: hexToBigInt(raw),
+            decimals: asset.decimals ?? native?.decimals ?? 18,
+            symbol: asset.symbol ?? native?.symbol,
+        };
+    }
+    const data = calldata(BALANCE_OF_SELECTOR, [addressWord(owner)]);
+    const [raw, decimals] = await Promise.all([
+        call(source, asset.token, data),
+        evmDecimals(source, asset.token, asset.decimals),
+    ]);
+    return {
+        asset,
+        amount: hexToBigInt(raw),
+        decimals,
+        symbol: asset.symbol,
+    };
+}
+/**
+ * The payer's balance of one Solana asset.
+ *
+ * RPC only. Solana wallets sign; they do not answer questions about the
+ * chain, so there is no provider path here the way there is on EVM.
+ *
+ * Token accounts are listed by mint rather than deriving the associated
+ * account address, which would mean shipping a program-derived-address
+ * implementation to answer a question the node can answer directly. An owner
+ * may hold several accounts for one mint, so they are summed.
+ */
+export async function readSvmBalance(rpcUrl, asset, owner) {
+    if (!asset.mint) {
+        const lamports = await rpc(rpcUrl, 'getBalance', [owner]);
+        const value = lamports?.value ?? 0;
+        return {
+            asset,
+            amount: BigInt(value),
+            decimals: asset.decimals ?? SOL_DECIMALS,
+            symbol: asset.symbol ?? 'SOL',
+        };
+    }
+    const result = await rpc(rpcUrl, 'getTokenAccountsByOwner', [
+        owner,
+        { mint: asset.mint },
+        { encoding: 'jsonParsed' },
+    ]);
+    const accounts = result?.value ?? [];
+    let amount = 0n;
+    let decimals = asset.decimals ?? 0;
+    for (const entry of accounts) {
+        const info = entry?.account?.data?.parsed?.info;
+        const token = info?.tokenAmount;
+        if (typeof token?.amount === 'string') {
+            amount += BigInt(token.amount);
+        }
+        if (asset.decimals === undefined && typeof token?.decimals === 'number') {
+            decimals = token.decimals;
+        }
+    }
+    return { asset, amount, decimals, symbol: asset.symbol };
+}
+/**
+ * Formats an amount for display, without ever making it a float.
+ *
+ * String arithmetic on the integer, not a division: the whole reason the
+ * amount is a bigint is that the moment it becomes a Number it stops being
+ * exact, and a balance is shown next to a charge the payer is about to
+ * approve.
+ */
+export function formatUnits(amount, decimals) {
+    const negative = amount < 0n;
+    const digits = (negative ? -amount : amount).toString().padStart(decimals + 1, '0');
+    const whole = digits.slice(0, digits.length - decimals);
+    const fraction = decimals > 0
+        ? digits.slice(digits.length - decimals).replace(/0+$/, '')
+        : '';
+    const sign = negative ? '-' : '';
+    return fraction ? `${sign}${whole}.${fraction}` : `${sign}${whole}`;
+}
+//# sourceMappingURL=balance.js.map

package/dist/balance.js.map

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

package/dist/base58.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Base58, encode only.
+ *
+ * Here for one reason: a wallet reached through the Wallet Standard returns a
+ * transaction signature as raw bytes, and every other part of this system
+ * names a Solana transaction by its base58 string. Nothing else in this
+ * bundle encodes anything; the transaction itself arrives already built.
+ *
+ * Big-integer division by repeated subtraction over the byte array, because
+ * 64 bytes exceeds what a JavaScript number can hold and a checkout page
+ * should not ship a bignum library to convert one signature.
+ */
+export declare function base58Encode(bytes: Uint8Array): string;
+/** Decodes the base64 the API sends raw bytes in. */
+export declare function fromBase64(value: string): Uint8Array;

package/dist/base58.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base58.d.ts","sourceRoot":"","sources":["../src/base58.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CA+BtD;AAED,qDAAqD;AACrD,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAOpD"}

package/dist/base58.js

@@ -0,0 +1,52 @@
+const ALPHABET = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';
+/**
+ * Base58, encode only.
+ *
+ * Here for one reason: a wallet reached through the Wallet Standard returns a
+ * transaction signature as raw bytes, and every other part of this system
+ * names a Solana transaction by its base58 string. Nothing else in this
+ * bundle encodes anything; the transaction itself arrives already built.
+ *
+ * Big-integer division by repeated subtraction over the byte array, because
+ * 64 bytes exceeds what a JavaScript number can hold and a checkout page
+ * should not ship a bignum library to convert one signature.
+ */
+export function base58Encode(bytes) {
+    if (bytes.length === 0) {
+        return '';
+    }
+    // Leading zero bytes are not part of the number and would be lost in the
+    // division, so they are counted off first and written back as '1's.
+    let zeros = 0;
+    while (zeros < bytes.length && bytes[zeros] === 0) {
+        zeros++;
+    }
+    const digits = [];
+    for (let i = zeros; i < bytes.length; i++) {
+        let carry = bytes[i];
+        for (let j = 0; j < digits.length; j++) {
+            carry += digits[j] << 8;
+            digits[j] = carry % 58;
+            carry = (carry / 58) | 0;
+        }
+        while (carry > 0) {
+            digits.push(carry % 58);
+            carry = (carry / 58) | 0;
+        }
+    }
+    let out = '1'.repeat(zeros);
+    for (let i = digits.length - 1; i >= 0; i--) {
+        out += ALPHABET[digits[i]];
+    }
+    return out;
+}
+/** Decodes the base64 the API sends raw bytes in. */
+export function fromBase64(value) {
+    const binary = atob(value);
+    const out = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+        out[i] = binary.charCodeAt(i);
+    }
+    return out;
+}
+//# sourceMappingURL=base58.js.map

package/dist/base58.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base58.js","sourceRoot":"","sources":["../src/base58.ts"],"names":[],"mappings":"AAAA,MAAM,QAAQ,GAAG,4DAA4D,CAAA;AAE7E;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,YAAY,CAAC,KAAiB;IAC7C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,CAAA;IACV,CAAC;IAED,yEAAyE;IACzE,oEAAoE;IACpE,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,OAAO,KAAK,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACnD,KAAK,EAAE,CAAA;IACR,CAAC;IAED,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,IAAI,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;QACpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,KAAK,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;YACvB,MAAM,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,EAAE,CAAA;YACtB,KAAK,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC,GAAG,CAAC,CAAA;QACzB,CAAC;QACD,OAAO,KAAK,GAAG,CAAC,EAAE,CAAC;YAClB,MAAM,CAAC,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC,CAAA;YACvB,KAAK,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC,GAAG,CAAC,CAAA;QACzB,CAAC;IACF,CAAC;IAED,IAAI,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAC3B,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7C,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;IAC3B,CAAC;IACD,OAAO,GAAG,CAAA;AACX,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,UAAU,CAAC,KAAa;IACvC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAA;IAC1B,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;IAC9B,CAAC;IACD,OAAO,GAAG,CAAA;AACX,CAAC"}