@b3dotfun/sdk 0.1.70-alpha.2 → 0.1.70-alpha.21

package/dist/esm/shared/constants/chains/b3Chain.js

@@ -52,11 +52,11 @@ export const b3Testnet = defineChain({
 export const b3Mainnet = defineChain({
     id: 8333,
     name: "B3",
-    rpc: "https://late-dimensional-yard.b3-mainnet.quiknode.pro/461dbdbd44158cd7a7a764a58ffb01a67eef77f2",
+    rpc: "https://mainnet-rpc.b3.fun",
     rpcUrls: {
         default: {
-            http: ["https://late-dimensional-yard.b3-mainnet.quiknode.pro/461dbdbd44158cd7a7a764a58ffb01a67eef77f2"],
-            ws: ["wss://late-dimensional-yard.b3-mainnet.quiknode.pro/461dbdbd44158cd7a7a764a58ffb01a67eef77f2"],
+            http: ["https://mainnet-rpc.b3.fun"],
+            ws: ["wss://mainnet-rpc.b3.fun/ws"],
         },
     },
     icon: {
@@ -77,26 +77,6 @@ export const b3Mainnet = defineChain({
         decimals: 18,
     },
 });
-export const getViemChainConfig = (config) => defineChain({
-    id: config.id,
-    name: config.name,
-    rpc: config.rpcUrls.default.http,
-    rpcUrls: {
-        default: {
-            http: [config.rpcUrls.default.http],
-            ws: [config.rpcUrls.default.ws],
-        },
-    },
-    icon: config.icon,
-    blockExplorers: {
-        default: {
-            name: config.blockExplorers.explorerTitle,
-            url: config.blockExplorers.default,
-        },
-    },
-    nativeCurrency: config.nativeCurrency,
-    testnet: config.testnet ? true : undefined,
-});
 export const thirdwebB3Testnet = defineThirdwebChain({
     id: 1993,
     name: "B3 Sepolia",
@@ -123,7 +103,7 @@ export const thirdwebB3Testnet = defineThirdwebChain({
 export const thirdwebB3Mainnet = defineThirdwebChain({
     id: 8333,
     name: "B3",
-    rpc: "https://late-dimensional-yard.b3-mainnet.quiknode.pro/461dbdbd44158cd7a7a764a58ffb01a67eef77f2/",
+    rpc: "https://mainnet-rpc.b3.fun",
     icon: {
         url: "https://cdn.b3.fun/b3_logo.svg",
         width: 32,
@@ -142,20 +122,6 @@ export const thirdwebB3Mainnet = defineThirdwebChain({
         decimals: 18,
     },
 });
-export const getThirdwebChainConfig = (config) => defineThirdwebChain({
-    id: config.id,
-    name: config.name,
-    rpc: config.rpcUrls.default.http,
-    icon: config.icon,
-    blockExplorers: [
-        {
-            name: config.blockExplorers.explorerTitle,
-            url: config.blockExplorers.default,
-        },
-    ],
-    nativeCurrency: config.nativeCurrency,
-    testnet: config.testnet ? true : undefined,
-});
 export const b3Chain = process.env.NEXT_PUBLIC_B3_CHAINID === "8333" ? b3Mainnet : b3Testnet;
 export const thirdwebB3Chain = process.env.NEXT_PUBLIC_B3_CHAINID === "8333" ? thirdwebB3Mainnet : thirdwebB3Testnet;
 export const b3Mask = "polygon( 2.209% 8.111%,2.211% 8.08%,2.212% 8.05%,2.212% 8.05%,2.238% 7.434%,2.295% 6.861%,2.382% 6.331%,2.498% 5.841%,2.644% 5.39%,2.817% 4.976%,3.018% 4.598%,3.247% 4.255%,3.502% 3.943%,3.783% 3.664%,3.783% 3.664%,4.107% 3.401%,4.464% 3.165%,4.857% 2.956%,5.285% 2.774%,5.749% 2.62%,6.249% 2.493%,6.786% 2.394%,7.361% 2.323%,7.974% 2.28%,8.625% 2.266%,8.642% 2.266%,8.66% 2.265%,8.66% 2.265%,16.702% 1.748%,24.751% 1.345%,32.805% 1.053%,40.864% 0.872%,48.924% 0.801%,56.984% 0.836%,65.044% 0.977%,73.101% 1.223%,81.153% 1.571%,89.2% 2.02%,89.2% 2.02%,89.394% 2.037%,89.59% 2.052%,89.789% 2.067%,89.989% 2.08%,90.19% 2.093%,90.393% 2.105%,90.596% 2.117%,90.8% 2.128%,91.004% 2.139%,91.207% 2.15%,91.207% 2.15%,91.357% 2.158%,91.506% 2.166%,91.655% 2.174%,91.803% 2.182%,91.95% 2.19%,92.097% 2.199%,92.242% 2.208%,92.386% 2.217%,92.529% 2.227%,92.67% 2.237%,92.67% 2.237%,93.011% 2.264%,93.347% 2.294%,93.677% 2.329%,94.002% 2.369%,94.321% 2.414%,94.634% 2.466%,94.94% 2.525%,95.239% 2.592%,95.53% 2.667%,95.813% 2.751%,95.813% 2.751%,96.087% 2.844%,96.349% 2.947%,96.6% 3.059%,96.839% 3.181%,97.066% 3.314%,97.282% 3.457%,97.485% 3.612%,97.676% 3.779%,97.855% 3.957%,98.021% 4.148%,98.021% 4.148%,98.172% 4.349%,98.313% 4.567%,98.444% 4.802%,98.563% 5.057%,98.67% 5.332%,98.764% 5.628%,98.845% 5.947%,98.912% 6.289%,98.964% 6.656%,99.001% 7.048%,99.002% 7.052%,99.002% 7.056%,99.002% 7.056%,99.127% 8.717%,99.245% 10.378%,99.355% 12.04%,99.46% 13.703%,99.56% 15.367%,99.654% 17.032%,99.745% 18.697%,99.832% 20.363%,99.917% 22.029%,100% 23.696%,100% 23.696%,100.219% 29.737%,100.382% 35.779%,100.489% 41.822%,100.539% 47.865%,100.534% 53.909%,100.472% 59.953%,100.353% 65.996%,100.179% 72.037%,99.947% 78.077%,99.659% 84.114%,99.659% 84.114%,99.655% 84.186%,99.651% 84.259%,99.646% 84.331%,99.642% 84.404%,99.637% 84.476%,99.633% 84.549%,99.629% 84.621%,99.624% 84.693%,99.615% 84.838%,99.615% 84.838%,99.565% 85.657%,99.515% 86.476%,99.464% 87.294%,99.412% 88.111%,99.36% 88.929%,99.306% 89.746%,99.251% 90.562%,99.194% 91.378%,99.135% 92.194%,99.074% 93.01%,99.072% 93.031%,99.071% 93.052%,99.071% 93.052%,99.049% 93.479%,99.012% 93.894%,98.959% 94.296%,98.89% 94.686%,98.805% 95.062%,98.702% 95.422%,98.582% 95.768%,98.444% 96.096%,98.288% 96.408%,98.113% 96.701%,98.113% 96.701%,97.92% 96.974%,97.703% 97.232%,97.461% 97.475%,97.194% 97.699%,96.898% 97.904%,96.574% 98.088%,96.219% 98.249%,95.833% 98.385%,95.414% 98.495%,94.961% 98.577%,94.961% 98.577%,92.494% 98.801%,90.025% 98.998%,87.553% 99.171%,85.079% 99.324%,82.604% 99.46%,80.126% 99.58%,77.648% 99.689%,75.169% 99.79%,72.689% 99.884%,70.208% 99.975%,69.528% 100%,69.528% 100%,69.528% 100%,69.528% 100%,69.528% 100%,69.528% 100%,69.528% 100%,69.527% 100%,69.527% 100%,69.527% 100%,69.527% 100%,63.379% 100.153%,57.23% 100.245%,51.081% 100.277%,44.931% 100.248%,38.783% 100.158%,32.635% 100.006%,26.489% 99.792%,20.346% 99.515%,14.205% 99.176%,8.068% 98.774%,8.058% 98.773%,8.048% 98.773%,8.048% 98.773%,7.501% 98.746%,6.992% 98.698%,6.518% 98.63%,6.079% 98.545%,5.673% 98.441%,5.299% 98.321%,4.956% 98.186%,4.641% 98.036%,4.354% 97.873%,4.094% 97.697%,4.094% 97.697%,3.862% 97.513%,3.65% 97.317%,3.457% 97.108%,3.281% 96.887%,3.123% 96.654%,2.98% 96.409%,2.852% 96.152%,2.737% 95.884%,2.635% 95.605%,2.545% 95.314%,2.545% 95.314%,2.463% 95.004%,2.391% 94.682%,2.329% 94.349%,2.276% 94.006%,2.23% 93.651%,2.192% 93.286%,2.159% 92.911%,2.131% 92.525%,2.106% 92.129%,2.085% 91.722%,2.085% 91.722%,2.081% 91.635%,2.077% 91.548%,2.073% 91.46%,2.069% 91.371%,2.066% 91.282%,2.062% 91.193%,2.058% 91.103%,2.054% 91.013%,2.051% 90.923%,2.047% 90.832%,2.047% 90.832%,2.033% 90.503%,2.019% 90.171%,2.003% 89.835%,1.986% 89.496%,1.966% 89.156%,1.944% 88.814%,1.918% 88.471%,1.889% 88.127%,1.855% 87.785%,1.817% 87.443%,1.817% 87.443%,1.594% 83.762%,1.403% 80.079%,1.241% 76.394%,1.104% 72.707%,0.99% 69.019%,0.894% 65.329%,0.813% 61.638%,0.744% 57.946%,0.682% 54.254%,0.626% 50.561%,0.626% 50.561%,0.637% 49.992%,0.648% 49.423%,0.659% 48.854%,0.67% 48.286%,0.681% 47.717%,0.692% 47.148%,0.703% 46.58%,0.713% 46.011%,0.724% 45.443%,0.734% 44.874%,0.734% 44.874%,0.782% 42.326%,0.831% 39.779%,0.884% 37.232%,0.941% 34.685%,1.006% 32.14%,1.078% 29.595%,1.161% 27.051%,1.255% 24.508%,1.363% 21.965%,1.485% 19.424%,1.485% 19.424%,1.493% 19.294%,1.5% 19.165%,1.508% 19.035%,1.515% 18.906%,1.523% 18.776%,1.531% 18.647%,1.538% 18.517%,1.546% 18.388%,1.553% 18.258%,1.561% 18.129%,1.561% 18.129%,1.619% 17.124%,1.678% 16.121%,1.737% 15.118%,1.798% 14.116%,1.86% 13.114%,1.925% 12.113%,1.991% 11.112%,2.06% 10.111%,2.133% 9.111%,2.209% 8.111% )";

package/dist/esm/shared/constants/chains/supported.d.ts

@@ -1,48 +1,7 @@
 import type { Chain as ThirdwebChain } from "thirdweb";
 export declare const supportedChains: import("viem").Chain[];
 export declare const supportedChainsTW: ThirdwebChain[];
-export declare const supportedChainNetworks: {
-    formatters?: Record<string, any> | undefined;
-    contracts?: Record<string, {
-        blockCreated?: number | undefined;
-        address: string;
-    }> | undefined;
-    sourceId?: number | undefined;
-    testnet?: boolean | undefined;
-    fees?: Record<string, any> | undefined;
-    color?: string | undefined;
-    testnetConfigID?: number | undefined;
-    badge?: string | undefined;
-    enabledFeatures?: string[] | undefined;
-    blockExplorers: {
-        default: string;
-        explorerTitle: string;
-    };
-    id: number;
-    name: string;
-    nativeCurrency: {
-        symbol: string;
-        name: string;
-        decimals: number;
-    };
-    rpcUrls: {
-        default: {
-            http: string;
-            ws: string;
-        };
-        backups: {
-            type: "http" | "ws";
-            uri: string;
-        }[];
-    };
-    _id: string | {};
-    icon: {
-        format: string;
-        url: string;
-        width: number;
-        height: number;
-    };
-}[];
+export declare const supportedChainNetworks: import("@b3/chain-registry/runtime").ChainDefinition[];
 export declare const coingeckoChains: Record<number, {
     coingecko_id: string;
     name: string;
@@ -56,14 +15,7 @@ export declare function getCoingeckoChainInfo(chainId: number): {
 export declare const b3MainnetThirdWeb: Readonly<import("thirdweb/chains").ChainOptions & {
     rpc: string;
 }>;
-export declare const b3TestnetThirdWeb: Readonly<import("thirdweb/chains").ChainOptions & {
-    rpc: string;
-}>;
 export declare const b3Mainnet: import("viem").Chain;
-export declare const b3Testnet: import("viem").Chain;
 export declare const baseMainnet: import("viem").Chain;
-/**
- * Get a Thirdweb chain by chain ID from supportedChainsTW
- */
 export declare function getThirdwebChain(chainId: number): ThirdwebChain;
 export declare function getChainLogo(chainId: number): string;

package/dist/esm/shared/constants/chains/supported.js

@@ -1,53 +1,25 @@
+import { ANYSPEND_EVM_CHAINS } from "@b3/chain-registry/runtime";
 import { toThirdwebChain, toViemChain } from "../../../shared/utils/chain-transformers.js";
 import invariant from "invariant";
-// Import the JSON directly
-// eslint-disable-next-line @typescript-eslint/ban-ts-comment
-// @ts-ignore
-import chainNetworksJSON from "../../generated/chain-networks.json" with { type: "json" };
 // eslint-disable-next-line @typescript-eslint/ban-ts-comment
 // @ts-ignore
 import coingeckoChainsJSON from "../../generated/coingecko-chains.json" with { type: "json" };
-const chainNetworks = chainNetworksJSON;
-// Convert custom chains to Viem format
-const viemChains = chainNetworks.map(toViemChain);
-// TODO: link to doc explaining why we don't support all chains and how to add more
-// These are the chains that are supported for things such as bridging and fetching balances
-export const supportedChains = [...viemChains];
-// ThirdWeb format chains
-export const supportedChainsTW = [
-    ...chainNetworks
-        .map(chain => {
-        const networkData = chainNetworks.find(n => n.id === chain.id);
-        return networkData ? toThirdwebChain(networkData) : undefined;
-    })
-        .filter((chain) => chain !== undefined),
-];
-// Original format from chain-networks.json
-export const supportedChainNetworks = chainNetworks;
-// CoinGecko chain mapping
+export const supportedChains = ANYSPEND_EVM_CHAINS.map(toViemChain);
+export const supportedChainsTW = ANYSPEND_EVM_CHAINS.map(toThirdwebChain);
+export const supportedChainNetworks = ANYSPEND_EVM_CHAINS;
 export const coingeckoChains = coingeckoChainsJSON;
-// Helper function to get CoinGecko chain info
 export function getCoingeckoChainInfo(chainId) {
     return coingeckoChains[chainId];
 }
-const _b3MainnetThirdWeb = supportedChainsTW.find(chain => chain.id === 8333);
+const _b3MainnetThirdWeb = supportedChainsTW.find(c => c.id === 8333);
 invariant(_b3MainnetThirdWeb, "B3 mainnet chain not found in supported chains TW");
 export const b3MainnetThirdWeb = _b3MainnetThirdWeb;
-const _b3TestnetThirdWeb = supportedChainsTW.find(chain => chain.id === 1993);
-invariant(_b3TestnetThirdWeb, "B3 testnet chain not found in supported chains TW");
-export const b3TestnetThirdWeb = _b3TestnetThirdWeb;
-const _b3Mainnet = supportedChains.find(chain => chain.id === 8333);
+const _b3Mainnet = supportedChains.find(c => c.id === 8333);
 invariant(_b3Mainnet, "B3 mainnet chain not found in supported chains");
 export const b3Mainnet = _b3Mainnet;
-const _b3Testnet = supportedChains.find(chain => chain.id === 1993);
-invariant(_b3Testnet, "B3 testnet chain not found in supported chains");
-export const b3Testnet = _b3Testnet;
-const _baseMainnet = supportedChains.find(chain => chain.id === 8453);
+const _baseMainnet = supportedChains.find(c => c.id === 8453);
 invariant(_baseMainnet, "Base mainnet chain not found in supported chains");
 export const baseMainnet = _baseMainnet;
-/**
- * Get a Thirdweb chain by chain ID from supportedChainsTW
- */
 export function getThirdwebChain(chainId) {
     const chain = supportedChainsTW.find(c => c.id === chainId);
     if (!chain) {

package/dist/esm/shared/constants/index.d.ts

@@ -1,7 +1,11 @@
+import type { Wallet } from "thirdweb/wallets";
 export * from "./currency";
 export declare const siteURL = "https://basement.fun";
 export declare const b3CoinIcon = "https://cdn.b3.fun/b3-coin-3d.png";
 export declare const ecosystemWalletId: `ecosystem.${string}`;
+export type EcosystemWallet = Wallet<`ecosystem.${string}`> & {
+    getAuthToken: () => string | null;
+};
 export declare const tokenIcons: {
     ETH: string;
     WETH: string;

package/dist/esm/shared/utils/chain-transformers.d.ts

@@ -1,5 +1,5 @@
-import type { ChainNetworks } from "../../global-account/types/chain-networks";
+import type { ChainDefinition } from "@b3/chain-registry";
 import type { Chain as ThirdwebChain } from "thirdweb";
-import { Chain } from "viem";
-export declare function toViemChain(network: ChainNetworks): Chain;
-export declare function toThirdwebChain(network: ChainNetworks): ThirdwebChain;
+import type { Chain } from "viem";
+export declare function toViemChain(chain: ChainDefinition): Chain;
+export declare function toThirdwebChain(chain: ChainDefinition): ThirdwebChain;

package/dist/esm/shared/utils/chain-transformers.js

@@ -1,46 +1,47 @@
 import { defineChain as defineThirdwebChain } from "thirdweb";
-export function toViemChain(network) {
+// fallbackRpc is validated non-null at chain-registry module init for every
+// anyspend EVM chain (see ANYSPEND_EVM_CHAINS in @b3/chain-registry). Callers
+// outside the anyspend EVM set must ensure their own data shape.
+// Derive icon format from URL extension. Thirdweb chain config carries an
+// explicit `format` field; the old chain-networks.json had per-chain values
+// (svg/png/etc.) but @b3/chain-registry only stores `logoUrl`. URL extension
+// is reliable across our current chain set — 9/11 anyspend chains use .png
+// (trustwallet/relay/coinmarketcap), 2 use .svg (Base, Plume from cdn.b3.fun).
+function inferIconFormat(url) {
+    const match = url.toLowerCase().match(/\.([a-z0-9]+)(?:\?|#|$)/);
+    const ext = match?.[1];
+    if (ext === "png" || ext === "jpg" || ext === "jpeg" || ext === "gif" || ext === "webp")
+        return ext;
+    return "svg";
+}
+export function toViemChain(chain) {
+    if (!chain.fallbackRpc) {
+        throw new Error(`toViemChain: chain ${chain.chainId} (${chain.key}) has no fallbackRpc`);
+    }
     return {
-        id: network.id,
-        name: network.name,
-        nativeCurrency: network.nativeCurrency,
-        rpcUrls: {
-            default: {
-                http: [network.rpcUrls.default.http],
-                webSocket: network.rpcUrls.default.ws ? [network.rpcUrls.default.ws] : undefined,
-            },
-        },
+        id: chain.chainId,
+        name: chain.name,
+        nativeCurrency: chain.nativeCurrency,
+        rpcUrls: { default: { http: [chain.fallbackRpc] } },
         blockExplorers: {
-            default: {
-                name: network.blockExplorers.explorerTitle,
-                url: network.blockExplorers.default,
-            },
+            default: { name: `${chain.name} Explorer`, url: chain.explorer },
         },
-        contracts: network.contracts,
-        testnet: network.testnet,
-        sourceId: network.sourceId,
-        formatters: network.formatters,
-        fees: network.fees,
+        testnet: chain.isTestnet,
     };
 }
-export function toThirdwebChain(network) {
+export function toThirdwebChain(chain) {
+    if (!chain.fallbackRpc) {
+        throw new Error(`toThirdwebChain: chain ${chain.chainId} (${chain.key}) has no fallbackRpc`);
+    }
     return defineThirdwebChain({
-        id: network.id,
-        name: network.name,
-        nativeCurrency: network.nativeCurrency,
-        rpc: network.rpcUrls.default.http,
-        icon: {
-            url: network.icon.url,
-            width: network.icon.width,
-            height: network.icon.height,
-            format: network.icon.format,
-        },
-        blockExplorers: [
-            {
-                name: network.blockExplorers.explorerTitle,
-                url: network.blockExplorers.default,
-            },
-        ],
-        testnet: network.testnet ? true : undefined,
+        id: chain.chainId,
+        name: chain.name,
+        nativeCurrency: chain.nativeCurrency,
+        rpc: chain.fallbackRpc,
+        icon: chain.logoUrl
+            ? { url: chain.logoUrl, width: 32, height: 32, format: inferIconFormat(chain.logoUrl) }
+            : undefined,
+        blockExplorers: [{ name: `${chain.name} Explorer`, url: chain.explorer }],
+        testnet: chain.isTestnet ? true : undefined,
     });
 }

package/dist/esm/shared/utils/thirdweb-insights.js

@@ -148,7 +148,7 @@ export async function getNativeTokenBalance(address, chainId) {
     }
     try {
         // Find chain info from supported chains
-        const chainInfo = supportedChainNetworks.find(chain => chain.id === chainId);
+        const chainInfo = supportedChainNetworks.find(chain => chain.chainId === chainId);
         // Create a chain object from the chainId
         const chain = defineChain({
             id: chainId,
@@ -176,7 +176,7 @@ export async function getNativeTokenBalance(address, chainId) {
             decimals: balance.decimals,
             balance: balance.value.toString(),
             metadata: {
-                logoURI: chainInfo?.icon?.url ||
+                logoURI: chainInfo?.logoUrl ||
                     "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/info/logo.png",
             },
             // Add native token info in extra_metadata

package/dist/esm/shared/utils/upload.d.ts

@@ -0,0 +1,9 @@
+interface UploadOptions {
+    baseUrl?: string;
+}
+/**
+ * Upload a file to the B3 uploads service (Cloudflare R2).
+ * Returns the public URL of the uploaded asset.
+ */
+export declare function uploadFile(file: File, options?: UploadOptions): Promise<string>;
+export {};

package/dist/esm/shared/utils/upload.js

@@ -0,0 +1,31 @@
+const DEFAULT_UPLOADS_URL = "https://uploads.b3.fun";
+const ALLOWED_TYPES = ["image/jpeg", "image/png", "image/gif", "image/webp"];
+const MAX_FILE_SIZE = 5 * 1024 * 1024; // 5MB
+/**
+ * Upload a file to the B3 uploads service (Cloudflare R2).
+ * Returns the public URL of the uploaded asset.
+ */
+export async function uploadFile(file, options) {
+    if (!ALLOWED_TYPES.includes(file.type)) {
+        throw new Error(`Invalid file type. Allowed: ${ALLOWED_TYPES.join(", ")}`);
+    }
+    if (file.size > MAX_FILE_SIZE) {
+        throw new Error(`File too large. Maximum size: ${MAX_FILE_SIZE / 1024 / 1024}MB`);
+    }
+    const uploadsUrl = options?.baseUrl || DEFAULT_UPLOADS_URL;
+    const formData = new FormData();
+    formData.append("file", file);
+    const res = await fetch(`${uploadsUrl}/upload/image`, {
+        method: "POST",
+        body: formData,
+    });
+    if (!res.ok) {
+        const body = await res.json().catch(() => ({ success: false, error: "Upload failed" }));
+        throw new Error(body.error || `Upload failed (${res.status})`);
+    }
+    const body = await res.json().catch(() => ({ success: false, error: "Invalid response" }));
+    if (!body.success || !body.data) {
+        throw new Error(body.error || "Upload failed");
+    }
+    return body.data.url;
+}

package/dist/esm/shared/utils/zerionPositions.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Canonical browser-side translation of Zerion wallet positions into B3 balance rows.
+ *
+ * This lives in the published SDK because every browser consumer needs it — the apps in this repo
+ * and the sites that install `@b3dotfun/sdk` from npm — and the in-repo Zerion client is a private
+ * workspace package that a published package cannot depend on. Backend services keep their own
+ * translation: pulling a browser SDK into a Node service to share one function is a worse trade
+ * than the second copy.
+ *
+ * Only the HTTP layer differs between callers. The rules below — which row counts as the chain's
+ * native coin, and which rows have no usable identity — must not be re-derived anywhere else.
+ */
+/** Address B3 uses for a chain's native coin on EVM. Matches NATIVE_TOKEN_ADDRESSES. */
+export declare const EVM_NATIVE_TOKEN_ADDRESS = "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee";
+export declare const SOLANA_NATIVE_TOKEN_ADDRESS: "So11111111111111111111111111111111111111112";
+export declare const SOLANA_ZERION_SLUG: "solana";
+/** Solana's chain id as the chain registry defines it — the id every balance row is keyed by. */
+export declare const SOLANA_CHAIN_ID: 7565164;
+export declare function zerionSlugToChainId(slug: string): number | undefined;
+export declare function chainIdToZerionSlug(chainId: number): string | undefined;
+export interface ZerionPositionQuantity {
+    int?: string;
+    decimals?: number;
+}
+export interface ZerionPositionImplementation {
+    chain_id?: string;
+    address?: string | null;
+    decimals?: number;
+}
+export interface ZerionPositionFungibleInfo {
+    name?: string;
+    symbol?: string;
+    icon?: {
+        url?: string;
+    } | null;
+    implementations?: ZerionPositionImplementation[];
+}
+export interface ZerionPositionLike {
+    id?: string;
+    attributes?: {
+        quantity?: ZerionPositionQuantity;
+        value?: number | null;
+        price?: number | null;
+        fungible_info?: ZerionPositionFungibleInfo;
+        flags?: {
+            displayable?: boolean;
+            is_trash?: boolean;
+        };
+    };
+    relationships?: {
+        chain?: {
+            data?: {
+                id?: string;
+            };
+        };
+    };
+}
+/** One spendable holding. `amount` is the raw integer; pair it with `decimals` to display. */
+export interface B3TokenBalance {
+    chain: string;
+    chain_id: number;
+    address: string;
+    amount: string;
+    symbol: string;
+    decimals: number;
+    /**
+     * Whether `address` is the native-coin sentinel rather than a real contract. Callers deciding
+     * between a value-bearing send and an ERC-20 `transfer` MUST branch on this, never on the
+     * sentinel string: getting it backwards spends gas and moves nothing.
+     */
+    is_native: boolean;
+    name?: string;
+    price_usd?: number;
+    value_usd?: number;
+    token_metadata?: {
+        logo: string;
+    };
+}
+export declare function nativeTokenAddressForChain(slug: string): string;
+/**
+ * Whether `balance` is the token identified by `tokenAddress`.
+ *
+ * Native coins are matched on the row's `is_native` flag rather than its printed address, because
+ * the caller and the adapter rarely spell the native coin the same way.
+ */
+export declare function balanceMatchesToken(balance: B3TokenBalance, tokenAddress: string): boolean;
+/**
+ * Adapt raw Zerion positions into balance rows, dropping any row we cannot describe honestly.
+ *
+ * A row is dropped when its chain slug is absent or unmapped, or when neither the quantity nor the
+ * chain implementation carries decimals — an amount rendered against a guessed scale is a wrong
+ * number presented as a real one, which is worse for the reader than a missing row.
+ *
+ * @param slugToChainId overrides slug resolution; return undefined to skip a chain entirely.
+ */
+export declare function adaptZerionPositions(positions: ZerionPositionLike[], slugToChainId?: (slug: string) => number | undefined): B3TokenBalance[];

package/dist/esm/shared/utils/zerionPositions.js

@@ -0,0 +1,180 @@
+import { SOLANA_NATIVE_ASSET } from "@b3/chain-registry/runtime";
+/**
+ * Canonical browser-side translation of Zerion wallet positions into B3 balance rows.
+ *
+ * This lives in the published SDK because every browser consumer needs it — the apps in this repo
+ * and the sites that install `@b3dotfun/sdk` from npm — and the in-repo Zerion client is a private
+ * workspace package that a published package cannot depend on. Backend services keep their own
+ * translation: pulling a browser SDK into a Node service to share one function is a worse trade
+ * than the second copy.
+ *
+ * Only the HTTP layer differs between callers. The rules below — which row counts as the chain's
+ * native coin, and which rows have no usable identity — must not be re-derived anywhere else.
+ */
+/** Address B3 uses for a chain's native coin on EVM. Matches NATIVE_TOKEN_ADDRESSES. */
+export const EVM_NATIVE_TOKEN_ADDRESS = "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee";
+export const SOLANA_NATIVE_TOKEN_ADDRESS = SOLANA_NATIVE_ASSET.wrapped
+    .address;
+export const SOLANA_ZERION_SLUG = SOLANA_NATIVE_ASSET.chain;
+/** What Zerion's `quantity.int` is: a base-10 integer, unbounded in length. */
+const DECIMAL_INTEGER_PATTERN = /^\d+$/;
+/** Solana's chain id as the chain registry defines it — the id every balance row is keyed by. */
+export const SOLANA_CHAIN_ID = SOLANA_NATIVE_ASSET.chainId;
+/**
+ * Zerion chain slug → numeric chain id. Slugs are Zerion's own vocabulary and do not always match
+ * the chain's common name — Gnosis is `xdai`, Metis is `metis-andromeda` — so an entry invented
+ * from the chain name silently drops every position on that chain, because the adapter skips any
+ * slug it cannot map. Every entry here is taken from Zerion's `GET /v1/chains/`.
+ */
+const ZERION_CHAIN_IDS = {
+    ethereum: 1,
+    optimism: 10,
+    "binance-smart-chain": 56,
+    xdai: 100,
+    unichain: 130,
+    polygon: 137,
+    sonic: 146,
+    fantom: 250,
+    "zksync-era": 324,
+    world: 480,
+    hyperevm: 999,
+    "metis-andromeda": 1088,
+    "polygon-zkevm": 1101,
+    soneium: 1868,
+    ronin: 2020,
+    abstract: 2741,
+    robinhood: 4663,
+    mantle: 5000,
+    base: 8453,
+    mode: 34443,
+    arbitrum: 42161,
+    celo: 42220,
+    avalanche: 43114,
+    linea: 59144,
+    berachain: 80094,
+    blast: 81457,
+    taiko: 167000,
+    scroll: 534352,
+    zora: 7777777,
+    degen: 666666666,
+    aurora: 1313161554,
+    [SOLANA_ZERION_SLUG]: SOLANA_CHAIN_ID,
+};
+// Maps rather than objects: a slug arrives straight off the wire, and an object lookup resolves an
+// inherited key like `constructor` or `toString` to something truthy instead of reporting the chain
+// as unknown — which would carry a row past the `=== undefined` guard with a function as its id.
+const CHAIN_ID_BY_ZERION_SLUG = new Map(Object.entries(ZERION_CHAIN_IDS));
+const ZERION_SLUG_BY_CHAIN_ID = new Map(Object.entries(ZERION_CHAIN_IDS).map(([slug, id]) => [id, slug]));
+export function zerionSlugToChainId(slug) {
+    return CHAIN_ID_BY_ZERION_SLUG.get(slug);
+}
+export function chainIdToZerionSlug(chainId) {
+    return ZERION_SLUG_BY_CHAIN_ID.get(chainId);
+}
+/**
+ * Zerion encodes a position's asset in the first hyphen-delimited segment of its resource `id`
+ * (`<assetRef>-<chainSlug>-<positionType>-…`). A chain's native coin uses the literal `base`
+ * (`base-polygon-asset-asset`); ERC-20s use the contract address
+ * (`0x1dd17…-ethereum-asset-asset`).
+ *
+ * This is the only reliable native signal. A falsy per-chain `implementation.address` looks
+ * equivalent and is not: Zerion reports Polygon's native coin at its `0x…1010` system contract and
+ * Celo's at a real ERC-20 address, while Polygon simultaneously carries a non-native fungible with
+ * the same `POL` symbol. Keying on the address shape misclassifies both.
+ */
+function isNativePosition(id, impl) {
+    if (id?.startsWith("base-") === true)
+        return true;
+    // Second signal, for the chains that spell native as an absent address. It requires the
+    // implementation to EXIST: a fungible with no entry for this chain tells us nothing about what
+    // the row is, and calling that native would hand a value-bearing send an amount we cannot name.
+    return impl !== undefined && !impl.address;
+}
+export function nativeTokenAddressForChain(slug) {
+    return slug === SOLANA_ZERION_SLUG ? SOLANA_NATIVE_TOKEN_ADDRESS : EVM_NATIVE_TOKEN_ADDRESS;
+}
+/**
+ * Every spelling of "the chain's own coin" a caller might hold.
+ *
+ * A token record's address depends on where it came from — a quote provider, a token list, a URL
+ * parameter — and each source names the native coin differently. Matching a balance row against any
+ * single one of these silently fails for the others.
+ */
+const NATIVE_TOKEN_MARKERS = new Set([
+    "native",
+    "0x0000000000000000000000000000000000000000",
+    EVM_NATIVE_TOKEN_ADDRESS,
+    SOLANA_NATIVE_TOKEN_ADDRESS.toLowerCase(),
+    "11111111111111111111111111111111",
+]);
+/**
+ * Whether `balance` is the token identified by `tokenAddress`.
+ *
+ * Native coins are matched on the row's `is_native` flag rather than its printed address, because
+ * the caller and the adapter rarely spell the native coin the same way.
+ */
+export function balanceMatchesToken(balance, tokenAddress) {
+    const wanted = tokenAddress.toLowerCase();
+    if (NATIVE_TOKEN_MARKERS.has(wanted))
+        return balance.is_native;
+    // Case-insensitive only for hex contract addresses. Solana mints are base58, where case is
+    // significant — lowercasing them would let two distinct mints compare equal.
+    if (balance.chain === SOLANA_ZERION_SLUG)
+        return balance.address === tokenAddress;
+    return balance.address.toLowerCase() === wanted;
+}
+/**
+ * Adapt raw Zerion positions into balance rows, dropping any row we cannot describe honestly.
+ *
+ * A row is dropped when its chain slug is absent or unmapped, or when neither the quantity nor the
+ * chain implementation carries decimals — an amount rendered against a guessed scale is a wrong
+ * number presented as a real one, which is worse for the reader than a missing row.
+ *
+ * @param slugToChainId overrides slug resolution; return undefined to skip a chain entirely.
+ */
+export function adaptZerionPositions(positions, slugToChainId = zerionSlugToChainId) {
+    const out = [];
+    for (const position of positions) {
+        const attributes = position.attributes ?? {};
+        const flags = attributes.flags;
+        if (flags && (flags.displayable === false || flags.is_trash === true))
+            continue;
+        const slug = position.relationships?.chain?.data?.id;
+        if (!slug)
+            continue;
+        const chainId = slugToChainId(slug);
+        if (chainId === undefined)
+            continue;
+        const fungibleInfo = attributes.fungible_info ?? {};
+        const implementation = (fungibleInfo.implementations ?? []).find(entry => entry.chain_id === slug);
+        const decimals = attributes.quantity?.decimals ?? implementation?.decimals;
+        if (decimals === undefined)
+            continue;
+        const isNative = isNativePosition(position.id, implementation);
+        // A non-native row with no contract address has no on-chain identity — drop it rather than
+        // render a holding nothing can name.
+        const address = isNative ? nativeTokenAddressForChain(slug) : implementation?.address;
+        if (!address)
+            continue;
+        // A quantity we cannot read is not a zero balance. Must be the base-10 integer `quantity.int`
+        // is: `null`, `""`, and any other unusable string all format to NaN, which callers coerce back
+        // to 0 and show as "holds none". `"0"` matches, so a real zero balance still comes through.
+        const amount = attributes.quantity?.int;
+        if (amount === undefined || !DECIMAL_INTEGER_PATTERN.test(amount))
+            continue;
+        out.push({
+            chain: slug,
+            chain_id: chainId,
+            address,
+            amount,
+            symbol: fungibleInfo.symbol ?? "",
+            decimals,
+            is_native: isNative,
+            name: fungibleInfo.name,
+            price_usd: attributes.price ?? undefined,
+            value_usd: attributes.value ?? undefined,
+            token_metadata: fungibleInfo.icon?.url ? { logo: fungibleInfo.icon.url } : undefined,
+        });
+    }
+    return out;
+}