@anywalletkit/tokens 0.0.0-stage → 0.1.1

package/dist/index.d.cts

@@ -0,0 +1,136 @@
+import { TokenFlag, TokenInfo, IWalletAccountReadOnly } from '@anywalletkit/core';
+import { CcAsset } from '@anywalletkit/swap2-assets';
+
+/** `danger`: the token can take or trap the user's money, or pretends to be another one. `caution`: worth knowing. */
+type TokenRiskLevel = 'danger' | 'caution';
+/**
+ * Why a token deserves a warning:
+ * - `unlisted`: always — the wallet's list does not include it, and anyone can deploy a token with any name and logo.
+ * - `impersonation`: its symbol reads as a known token's (USDC, ETH, …), look-alike letters included.
+ * - `odd-characters`: its symbol or name uses characters outside plain ASCII, or invisible ones.
+ * - `no-symbol`: it reports no symbol.
+ * - `zero-supply`: nothing has been minted.
+ * - `unusual-decimals`: more than 24 decimals.
+ * - a {@link TokenFlag} read from the chain (issuer powers, Token-2022 extensions).
+ */
+type TokenRiskCode = 'unlisted' | 'impersonation' | 'odd-characters' | 'no-symbol' | 'zero-supply' | 'unusual-decimals' | TokenFlag;
+/** One warning, worded for the person adding the token. */
+interface TokenRisk {
+    code: TokenRiskCode;
+    level: TokenRiskLevel;
+    message: string;
+}
+/** Every warning that applies, worst first, and the worst level. A user token is never "safe": `caution` is the floor. */
+interface TokenAssessment {
+    level: TokenRiskLevel;
+    risks: TokenRisk[];
+}
+/** A symbol folded the way a reader sees it: invisible characters gone, compatibility forms unified, look-alikes mapped, upper case. */
+declare function foldSymbol(text: string): string;
+/**
+ * Warnings for a token read with `getTokenInfo`, for a token the wallet's list does not include.
+ * Pure: nothing is fetched. `impersonation` when its symbol (look-alike letters folded) reads as a
+ * catalog token on the same `chain` — the real one would be in the list, this is another contract —
+ * or as a native coin or major stablecoin anywhere. A bridged token of another chain's list (JUP on
+ * Solana, listed on Unichain) is not flagged.
+ */
+declare function assessToken(info: TokenInfo, chain?: string): TokenAssessment;
+
+/** One JSON value under one key — the shape every small store needs (AsyncStorage, chrome.storage, memory). */
+interface JsonStorage<T> {
+    /** The stored value, or `null` on first run. */
+    get(): Promise<T | null>;
+    /** Persist the value. */
+    set(value: T): Promise<void>;
+}
+/** In-memory storage for tests and smoke runs. */
+declare function memoryJsonStorage<T>(initial?: T | null): JsonStorage<T> & {
+    value: T | null;
+};
+/** A token the user added. `symbol` and `name` are what the token reports: display them, never match on them. */
+interface UserToken {
+    /** CAIP-2 chain id, the catalog's key (`solana:mainnet`, `eip155:1`). */
+    chain: string;
+    /** Contract (EVM, checksummed as read) or mint (Solana). The token's identity. */
+    address: string;
+    symbol: string;
+    name: string;
+    decimals: number;
+    /** `erc20`, `spl` or `spl-token-2022`. */
+    standard: string;
+    /** Facts read from the chain when it was added. */
+    flags: TokenFlag[];
+    /** When the user added it (ms since epoch). */
+    addedAt: number;
+}
+/** What {@link TokensTable} stores. */
+interface TokensState {
+    v: 1;
+    tokens: UserToken[];
+}
+/** Codes of {@link TokensError}. */
+type TokensErrorCode = 'not-loaded' | 'unsupported-chain' | 'bad-address' | 'listed' | 'bad-token' | 'full';
+/** A refusal from the tokens table or {@link inspectToken}, with a machine-readable `code`. */
+declare class TokensError extends Error {
+    readonly code: TokensErrorCode;
+    constructor(code: TokensErrorCode, message: string);
+}
+/** The result of looking a token up before adding it. */
+type TokenInspection = {
+    listed: CcAsset;
+} | {
+    listed?: undefined;
+    info: TokenInfo;
+    assessment: TokenAssessment;
+    token: UserToken;
+};
+/**
+ * Read a token from the chain through `account` (its chain decides where) and assess it. A token the
+ * catalog already lists comes back as `{ listed }`: nothing to add. Otherwise the token, ready for
+ * {@link TokensTable.add}, and the warnings to show first. Throws {@link TokensError}
+ * (`unsupported-chain`, `bad-address`) or the chain package's `NotATokenError`.
+ */
+declare function inspectToken(account: Pick<IWalletAccountReadOnly, 'chain' | 'getTokenInfo'> & {
+    getChainId?: () => Promise<number | bigint>;
+}, address: string, now?: () => number): Promise<TokenInspection>;
+/**
+ * The swap options that name a user token as the source: its address and decimals. Pass them to an
+ * engine created with `allowUnlistedTokens: true`.
+ */
+declare function swapSource(token: Pick<UserToken, 'address' | 'decimals'>): {
+    fromToken: string;
+    fromTokenDecimals: number;
+};
+/**
+ * The user's own tokens, over any JSON storage: load once at cold start, then read synchronously.
+ * Writes queue behind each other; a failed save leaves memory as stored. Tokens the catalog lists are
+ * refused (they are already there), and so are addresses that are not EVM contracts or Solana mints.
+ */
+declare class TokensTable {
+    private readonly storage;
+    private _state;
+    private _loading;
+    private _writes;
+    private readonly listeners;
+    readonly maxTokens: number;
+    constructor(storage: JsonStorage<TokensState>, options?: {
+        maxTokens?: number;
+    });
+    /** Read the stored list. Call once before the sync reads; a failed read throws and leaves the table unloaded. */
+    load(): Promise<void>;
+    /** Called after every successful write. Returns the unsubscribe function. */
+    subscribe(fn: () => void): () => void;
+    /** The user's tokens, oldest first; only those on `chain` when given. */
+    list(chain?: string): UserToken[];
+    /** The user token at `address` on `chain`, if added. */
+    get(chain: string, address: string): UserToken | undefined;
+    /** Add (or refresh) a token — usually `inspection.token` after the user accepted the warnings. */
+    add(token: UserToken): Promise<UserToken>;
+    /** Remove a token. Returns whether it was there. */
+    remove(chain: string, address: string): Promise<boolean>;
+    private loaded;
+    private state;
+    private update;
+}
+
+export { type JsonStorage, type TokenAssessment, type TokenInspection, type TokenRisk, type TokenRiskCode, type TokenRiskLevel, TokensError, type TokensErrorCode, type TokensState, TokensTable, type UserToken, assessToken, foldSymbol, inspectToken, memoryJsonStorage, swapSource };

package/dist/index.d.ts

@@ -0,0 +1,136 @@
+import { TokenFlag, TokenInfo, IWalletAccountReadOnly } from '@anywalletkit/core';
+import { CcAsset } from '@anywalletkit/swap2-assets';
+
+/** `danger`: the token can take or trap the user's money, or pretends to be another one. `caution`: worth knowing. */
+type TokenRiskLevel = 'danger' | 'caution';
+/**
+ * Why a token deserves a warning:
+ * - `unlisted`: always — the wallet's list does not include it, and anyone can deploy a token with any name and logo.
+ * - `impersonation`: its symbol reads as a known token's (USDC, ETH, …), look-alike letters included.
+ * - `odd-characters`: its symbol or name uses characters outside plain ASCII, or invisible ones.
+ * - `no-symbol`: it reports no symbol.
+ * - `zero-supply`: nothing has been minted.
+ * - `unusual-decimals`: more than 24 decimals.
+ * - a {@link TokenFlag} read from the chain (issuer powers, Token-2022 extensions).
+ */
+type TokenRiskCode = 'unlisted' | 'impersonation' | 'odd-characters' | 'no-symbol' | 'zero-supply' | 'unusual-decimals' | TokenFlag;
+/** One warning, worded for the person adding the token. */
+interface TokenRisk {
+    code: TokenRiskCode;
+    level: TokenRiskLevel;
+    message: string;
+}
+/** Every warning that applies, worst first, and the worst level. A user token is never "safe": `caution` is the floor. */
+interface TokenAssessment {
+    level: TokenRiskLevel;
+    risks: TokenRisk[];
+}
+/** A symbol folded the way a reader sees it: invisible characters gone, compatibility forms unified, look-alikes mapped, upper case. */
+declare function foldSymbol(text: string): string;
+/**
+ * Warnings for a token read with `getTokenInfo`, for a token the wallet's list does not include.
+ * Pure: nothing is fetched. `impersonation` when its symbol (look-alike letters folded) reads as a
+ * catalog token on the same `chain` — the real one would be in the list, this is another contract —
+ * or as a native coin or major stablecoin anywhere. A bridged token of another chain's list (JUP on
+ * Solana, listed on Unichain) is not flagged.
+ */
+declare function assessToken(info: TokenInfo, chain?: string): TokenAssessment;
+
+/** One JSON value under one key — the shape every small store needs (AsyncStorage, chrome.storage, memory). */
+interface JsonStorage<T> {
+    /** The stored value, or `null` on first run. */
+    get(): Promise<T | null>;
+    /** Persist the value. */
+    set(value: T): Promise<void>;
+}
+/** In-memory storage for tests and smoke runs. */
+declare function memoryJsonStorage<T>(initial?: T | null): JsonStorage<T> & {
+    value: T | null;
+};
+/** A token the user added. `symbol` and `name` are what the token reports: display them, never match on them. */
+interface UserToken {
+    /** CAIP-2 chain id, the catalog's key (`solana:mainnet`, `eip155:1`). */
+    chain: string;
+    /** Contract (EVM, checksummed as read) or mint (Solana). The token's identity. */
+    address: string;
+    symbol: string;
+    name: string;
+    decimals: number;
+    /** `erc20`, `spl` or `spl-token-2022`. */
+    standard: string;
+    /** Facts read from the chain when it was added. */
+    flags: TokenFlag[];
+    /** When the user added it (ms since epoch). */
+    addedAt: number;
+}
+/** What {@link TokensTable} stores. */
+interface TokensState {
+    v: 1;
+    tokens: UserToken[];
+}
+/** Codes of {@link TokensError}. */
+type TokensErrorCode = 'not-loaded' | 'unsupported-chain' | 'bad-address' | 'listed' | 'bad-token' | 'full';
+/** A refusal from the tokens table or {@link inspectToken}, with a machine-readable `code`. */
+declare class TokensError extends Error {
+    readonly code: TokensErrorCode;
+    constructor(code: TokensErrorCode, message: string);
+}
+/** The result of looking a token up before adding it. */
+type TokenInspection = {
+    listed: CcAsset;
+} | {
+    listed?: undefined;
+    info: TokenInfo;
+    assessment: TokenAssessment;
+    token: UserToken;
+};
+/**
+ * Read a token from the chain through `account` (its chain decides where) and assess it. A token the
+ * catalog already lists comes back as `{ listed }`: nothing to add. Otherwise the token, ready for
+ * {@link TokensTable.add}, and the warnings to show first. Throws {@link TokensError}
+ * (`unsupported-chain`, `bad-address`) or the chain package's `NotATokenError`.
+ */
+declare function inspectToken(account: Pick<IWalletAccountReadOnly, 'chain' | 'getTokenInfo'> & {
+    getChainId?: () => Promise<number | bigint>;
+}, address: string, now?: () => number): Promise<TokenInspection>;
+/**
+ * The swap options that name a user token as the source: its address and decimals. Pass them to an
+ * engine created with `allowUnlistedTokens: true`.
+ */
+declare function swapSource(token: Pick<UserToken, 'address' | 'decimals'>): {
+    fromToken: string;
+    fromTokenDecimals: number;
+};
+/**
+ * The user's own tokens, over any JSON storage: load once at cold start, then read synchronously.
+ * Writes queue behind each other; a failed save leaves memory as stored. Tokens the catalog lists are
+ * refused (they are already there), and so are addresses that are not EVM contracts or Solana mints.
+ */
+declare class TokensTable {
+    private readonly storage;
+    private _state;
+    private _loading;
+    private _writes;
+    private readonly listeners;
+    readonly maxTokens: number;
+    constructor(storage: JsonStorage<TokensState>, options?: {
+        maxTokens?: number;
+    });
+    /** Read the stored list. Call once before the sync reads; a failed read throws and leaves the table unloaded. */
+    load(): Promise<void>;
+    /** Called after every successful write. Returns the unsubscribe function. */
+    subscribe(fn: () => void): () => void;
+    /** The user's tokens, oldest first; only those on `chain` when given. */
+    list(chain?: string): UserToken[];
+    /** The user token at `address` on `chain`, if added. */
+    get(chain: string, address: string): UserToken | undefined;
+    /** Add (or refresh) a token — usually `inspection.token` after the user accepted the warnings. */
+    add(token: UserToken): Promise<UserToken>;
+    /** Remove a token. Returns whether it was there. */
+    remove(chain: string, address: string): Promise<boolean>;
+    private loaded;
+    private state;
+    private update;
+}
+
+export { type JsonStorage, type TokenAssessment, type TokenInspection, type TokenRisk, type TokenRiskCode, type TokenRiskLevel, TokensError, type TokensErrorCode, type TokensState, TokensTable, type UserToken, assessToken, foldSymbol, inspectToken, memoryJsonStorage, swapSource };

package/dist/index.js

@@ -0,0 +1,301 @@
+// src/assess.ts
+import { CC_SOURCE_CHAINS, catalogChainId, ccChain } from "@anywalletkit/swap2-assets";
+var FLAG_RISKS = {
+  "upgradeable": { level: "caution", message: "The token's owner can replace its code." },
+  "mint-authority": { level: "caution", message: "The issuer can mint more at any time." },
+  "freeze-authority": { level: "caution", message: "The issuer can freeze your balance." },
+  "permanent-delegate": { level: "danger", message: "The issuer can move or burn the tokens in your wallet." },
+  "transfer-fee": { level: "caution", message: "Every transfer pays a fee to the issuer." },
+  "transfer-hook": { level: "danger", message: "A program of the issuer's choosing runs on every transfer: it can block selling." },
+  "non-transferable": { level: "danger", message: "It cannot be moved: not sent, not swapped." },
+  "default-frozen": { level: "caution", message: "New holders start frozen until the issuer lets them move it." },
+  "pausable": { level: "caution", message: "The issuer can pause every transfer." }
+};
+var CONFUSABLES = {
+  "\u0410": "A",
+  "\u0412": "B",
+  "\u0415": "E",
+  "\u041A": "K",
+  "\u041C": "M",
+  "\u041D": "H",
+  "\u041E": "O",
+  "\u0420": "P",
+  "\u0421": "C",
+  "\u0422": "T",
+  "\u0425": "X",
+  "\u0423": "Y",
+  "\u0406": "I",
+  "\u0408": "J",
+  "\u0405": "S",
+  "\u0500": "D",
+  "\u0430": "A",
+  "\u0432": "B",
+  "\u0435": "E",
+  "\u043A": "K",
+  "\u043C": "M",
+  "\u043D": "H",
+  "\u043E": "O",
+  "\u0440": "P",
+  "\u0441": "C",
+  "\u0442": "T",
+  "\u0445": "X",
+  "\u0443": "Y",
+  "\u0456": "I",
+  "\u0458": "J",
+  "\u0455": "S",
+  "\u0501": "D",
+  "\u0391": "A",
+  "\u0392": "B",
+  "\u0395": "E",
+  "\u0396": "Z",
+  "\u0397": "H",
+  "\u0399": "I",
+  "\u039A": "K",
+  "\u039C": "M",
+  "\u039D": "N",
+  "\u039F": "O",
+  "\u03A1": "P",
+  "\u03A4": "T",
+  "\u03A5": "Y",
+  "\u03A7": "X",
+  "\u03B1": "A",
+  "\u03B5": "E",
+  "\u03B9": "I",
+  "\u03BA": "K",
+  "\u03BD": "V",
+  "\u03BF": "O",
+  "\u03C1": "P",
+  "\u03C4": "T",
+  "\u03C5": "U",
+  "\u03C7": "X",
+  "$": "S",
+  "\u20AE": "T",
+  "\u20AC": "E",
+  "\xA2": "C",
+  "\u20BF": "B",
+  "\u039E": "E"
+};
+var INVISIBLE = /[­͏؜ᅟᅠ឴឵᠋-᠏​-‏‪-‮⁠-ㅤ︀-️ﾠ]/g;
+function foldSymbol(text) {
+  let s = text.replace(INVISIBLE, "").replace(/\s+/g, "");
+  if (typeof s.normalize === "function") s = s.normalize("NFKC");
+  s = s.replace(/[\uFF01-\uFF5E]/g, (c) => String.fromCharCode(c.charCodeAt(0) - 65248));
+  let out = "";
+  for (const ch of s) out += CONFUSABLES[ch] ?? ch;
+  return out.toUpperCase();
+}
+var MAJOR_TOKENS = ["USDT", "USDC", "DAI", "USDe", "USDS", "PYUSD", "FDUSD", "USD1", "USDG", "EURC", "WETH", "WBTC", "cbBTC", "stETH", "wstETH", "WSOL"];
+var majors;
+function majorSymbols() {
+  if (majors) return majors;
+  const m = /* @__PURE__ */ new Map();
+  for (const chain of CC_SOURCE_CHAINS) for (const a of chain.assets) if (!a.contract && !m.has(foldSymbol(a.symbol))) m.set(foldSymbol(a.symbol), a.symbol);
+  for (const sym of MAJOR_TOKENS) if (!m.has(foldSymbol(sym))) m.set(foldSymbol(sym), sym);
+  majors = m;
+  return m;
+}
+function lookalikeOf(folded, chain) {
+  if (!folded) return void 0;
+  if (chain) {
+    const same = ccChain(catalogChainId(chain))?.assets.find((a) => foldSymbol(a.symbol) === folded);
+    if (same) return same.symbol;
+  }
+  return majorSymbols().get(folded);
+}
+var PLAIN = /^[\x20-\x7E]*$/;
+function assessToken(info, chain) {
+  const risks = [{ code: "unlisted", level: "caution", message: "Not in the wallet's token list. Anyone can create a token with any name and logo: check the address with the project itself." }];
+  const folded = foldSymbol(info.symbol);
+  const lookalike = lookalikeOf(folded, chain);
+  if (lookalike) {
+    risks.push({ code: "impersonation", level: "danger", message: `It calls itself ${JSON.stringify(info.symbol)}, like ${lookalike}, but it is a different token at a different address.` });
+  }
+  if (!PLAIN.test(info.symbol) || !PLAIN.test(info.name) || info.symbol !== info.symbol.replace(INVISIBLE, "") || info.name !== info.name.replace(INVISIBLE, "")) {
+    risks.push({ code: "odd-characters", level: "caution", message: "Its symbol or name uses characters that can look like other letters, or invisible ones." });
+  }
+  if (!info.symbol.trim()) risks.push({ code: "no-symbol", level: "caution", message: "The token reports no symbol." });
+  if (info.totalSupply === 0n) risks.push({ code: "zero-supply", level: "caution", message: "Nothing has been minted." });
+  if (info.decimals > 24) risks.push({ code: "unusual-decimals", level: "caution", message: `It uses ${info.decimals} decimals; amounts may display oddly.` });
+  for (const flag of info.flags) {
+    const r = FLAG_RISKS[flag];
+    if (r) risks.push({ code: flag, ...r });
+  }
+  risks.sort((a, b) => a.level === b.level ? 0 : a.level === "danger" ? -1 : 1);
+  return { level: risks.some((r) => r.level === "danger") ? "danger" : "caution", risks };
+}
+
+// src/table.ts
+import { catalogChainId as catalogChainId2, ccAssetByToken, isTokenAddress } from "@anywalletkit/swap2-assets";
+function memoryJsonStorage(initial = null) {
+  const clone = (v) => JSON.parse(JSON.stringify(v));
+  const s = {
+    value: initial,
+    async get() {
+      return s.value === null ? null : clone(s.value);
+    },
+    async set(value) {
+      s.value = clone(value);
+    }
+  };
+  return s;
+}
+var TokensError = class extends Error {
+  code;
+  constructor(code, message) {
+    super(message);
+    this.name = "TokensError";
+    this.code = code;
+  }
+};
+var sameAddress = (chain, a, b) => chain.startsWith("eip155:") ? a.toLowerCase() === b.toLowerCase() : a === b;
+var FLAGS = /* @__PURE__ */ new Set(["upgradeable", "mint-authority", "freeze-authority", "permanent-delegate", "transfer-fee", "transfer-hook", "non-transferable", "default-frozen", "pausable"]);
+function validEntry(t) {
+  if (!t || typeof t !== "object") return null;
+  const e = t;
+  if (typeof e.chain !== "string" || typeof e.address !== "string" || !isTokenAddress(e.chain, e.address)) return null;
+  if (typeof e.decimals !== "number" || !Number.isInteger(e.decimals) || e.decimals < 0 || e.decimals > 77) return null;
+  if (typeof e.symbol !== "string" || typeof e.name !== "string" || typeof e.standard !== "string" || typeof e.addedAt !== "number") return null;
+  if (!Array.isArray(e.flags) || !e.flags.every((f) => typeof f === "string" && FLAGS.has(f))) return null;
+  return {
+    chain: e.chain,
+    address: e.address,
+    symbol: e.symbol.slice(0, 128),
+    name: e.name.slice(0, 128),
+    decimals: e.decimals,
+    standard: e.standard,
+    flags: [...e.flags],
+    addedAt: e.addedAt
+  };
+}
+async function inspectToken(account, address, now = Date.now) {
+  let reported = account.chain;
+  if (reported === "eip155:unknown") {
+    if (typeof account.getChainId !== "function") throw new TokensError("unsupported-chain", "The account does not know its chain id; create it with chainId.");
+    reported = `eip155:${String(await account.getChainId())}`;
+  }
+  const chain = catalogChainId2(reported);
+  if (!chain.startsWith("eip155:") && !chain.startsWith("solana:")) throw new TokensError("unsupported-chain", `Adding tokens is supported on EVM chains and Solana, not ${account.chain}.`);
+  const ref = address.trim();
+  if (!isTokenAddress(chain, ref)) throw new TokensError("bad-address", `${JSON.stringify(address)} is not a token address on ${chain}.`);
+  const listed = ccAssetByToken(chain, ref);
+  if (listed) return { listed };
+  if (typeof account.getTokenInfo !== "function") throw new TokensError("unsupported-chain", `This ${account.chain} account cannot read token info.`);
+  const info = await account.getTokenInfo(ref);
+  const token = {
+    chain,
+    address: info.address,
+    symbol: info.symbol.slice(0, 128),
+    name: info.name.slice(0, 128),
+    decimals: info.decimals,
+    standard: info.standard,
+    flags: [...info.flags],
+    addedAt: now()
+  };
+  return { info, assessment: assessToken(info, chain), token };
+}
+function swapSource(token) {
+  return { fromToken: token.address, fromTokenDecimals: token.decimals };
+}
+var TokensTable = class {
+  constructor(storage, options = {}) {
+    this.storage = storage;
+    this.maxTokens = options.maxTokens ?? 200;
+  }
+  storage;
+  _state = null;
+  _loading = null;
+  _writes = Promise.resolve();
+  listeners = /* @__PURE__ */ new Set();
+  maxTokens;
+  /** Read the stored list. Call once before the sync reads; a failed read throws and leaves the table unloaded. */
+  async load() {
+    await this.state();
+  }
+  /** Called after every successful write. Returns the unsubscribe function. */
+  subscribe(fn) {
+    this.listeners.add(fn);
+    return () => {
+      this.listeners.delete(fn);
+    };
+  }
+  /** The user's tokens, oldest first; only those on `chain` when given. */
+  list(chain) {
+    const s = this.loaded();
+    const want = chain === void 0 ? void 0 : catalogChainId2(chain);
+    return s.tokens.filter((t) => want === void 0 || t.chain === want).map((t) => ({ ...t, flags: [...t.flags] }));
+  }
+  /** The user token at `address` on `chain`, if added. */
+  get(chain, address) {
+    const c = catalogChainId2(chain);
+    const t = this.loaded().tokens.find((x) => x.chain === c && sameAddress(c, x.address, address));
+    return t ? { ...t, flags: [...t.flags] } : void 0;
+  }
+  /** Add (or refresh) a token — usually `inspection.token` after the user accepted the warnings. */
+  async add(token) {
+    const entry = validEntry({ ...token, chain: catalogChainId2(token.chain) });
+    if (!entry) throw new TokensError("bad-token", "Not a valid token entry (address, decimals 0\u201377, symbol, name, standard, flags).");
+    if (ccAssetByToken(entry.chain, entry.address)) throw new TokensError("listed", `${entry.address} is already in the wallet's token list.`);
+    await this.update((s) => {
+      const rest = s.tokens.filter((t) => !(t.chain === entry.chain && sameAddress(entry.chain, t.address, entry.address)));
+      if (rest.length >= this.maxTokens) throw new TokensError("full", `At most ${this.maxTokens} tokens can be added.`);
+      return { v: 1, tokens: [...rest, entry] };
+    });
+    return { ...entry, flags: [...entry.flags] };
+  }
+  /** Remove a token. Returns whether it was there. */
+  async remove(chain, address) {
+    const c = catalogChainId2(chain);
+    let removed = false;
+    await this.update((s) => {
+      const rest = s.tokens.filter((t) => !(t.chain === c && sameAddress(c, t.address, address)));
+      removed = rest.length !== s.tokens.length;
+      return { v: 1, tokens: rest };
+    });
+    return removed;
+  }
+  loaded() {
+    if (!this._state) throw new TokensError("not-loaded", "Call load() before reading the tokens table.");
+    return this._state;
+  }
+  async state() {
+    if (this._state) return this._state;
+    this._loading ??= (async () => {
+      let stored;
+      try {
+        stored = await this.storage.get();
+      } catch (e) {
+        this._loading = null;
+        throw e;
+      }
+      const tokens = stored && stored.v === 1 && Array.isArray(stored.tokens) ? stored.tokens.map(validEntry).filter((t) => t !== null) : [];
+      this._state = { v: 1, tokens };
+      return this._state;
+    })();
+    return this._loading;
+  }
+  update(change) {
+    const run = this._writes.then(async () => {
+      const next = change(await this.state());
+      await this.storage.set(next);
+      this._state = next;
+      for (const fn of this.listeners) {
+        try {
+          fn();
+        } catch {
+        }
+      }
+    });
+    this._writes = run.catch(() => void 0);
+    return run;
+  }
+};
+export {
+  TokensError,
+  TokensTable,
+  assessToken,
+  foldSymbol,
+  inspectToken,
+  memoryJsonStorage,
+  swapSource
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/assess.ts","../src/table.ts"],"sourcesContent":["import type { TokenFlag, TokenInfo } from '@anywalletkit/core'\nimport { CC_SOURCE_CHAINS, catalogChainId, ccChain } from '@anywalletkit/swap2-assets'\n\n/** `danger`: the token can take or trap the user's money, or pretends to be another one. `caution`: worth knowing. */\nexport type TokenRiskLevel = 'danger' | 'caution'\n\n/**\n * Why a token deserves a warning:\n * - `unlisted`: always — the wallet's list does not include it, and anyone can deploy a token with any name and logo.\n * - `impersonation`: its symbol reads as a known token's (USDC, ETH, …), look-alike letters included.\n * - `odd-characters`: its symbol or name uses characters outside plain ASCII, or invisible ones.\n * - `no-symbol`: it reports no symbol.\n * - `zero-supply`: nothing has been minted.\n * - `unusual-decimals`: more than 24 decimals.\n * - a {@link TokenFlag} read from the chain (issuer powers, Token-2022 extensions).\n */\nexport type TokenRiskCode = 'unlisted' | 'impersonation' | 'odd-characters' | 'no-symbol' | 'zero-supply' | 'unusual-decimals' | TokenFlag\n\n/** One warning, worded for the person adding the token. */\nexport interface TokenRisk {\n  code: TokenRiskCode\n  level: TokenRiskLevel\n  message: string\n}\n\n/** Every warning that applies, worst first, and the worst level. A user token is never \"safe\": `caution` is the floor. */\nexport interface TokenAssessment {\n  level: TokenRiskLevel\n  risks: TokenRisk[]\n}\n\nconst FLAG_RISKS: Readonly<Record<TokenFlag, { level: TokenRiskLevel; message: string }>> = {\n  'upgradeable': { level: 'caution', message: \"The token's owner can replace its code.\" },\n  'mint-authority': { level: 'caution', message: 'The issuer can mint more at any time.' },\n  'freeze-authority': { level: 'caution', message: 'The issuer can freeze your balance.' },\n  'permanent-delegate': { level: 'danger', message: 'The issuer can move or burn the tokens in your wallet.' },\n  'transfer-fee': { level: 'caution', message: 'Every transfer pays a fee to the issuer.' },\n  'transfer-hook': { level: 'danger', message: \"A program of the issuer's choosing runs on every transfer: it can block selling.\" },\n  'non-transferable': { level: 'danger', message: 'It cannot be moved: not sent, not swapped.' },\n  'default-frozen': { level: 'caution', message: 'New holders start frozen until the issuer lets them move it.' },\n  'pausable': { level: 'caution', message: 'The issuer can pause every transfer.' },\n}\n\n/** Letters that render like Latin capitals (Cyrillic, Greek) and currency signs used as letters. */\nconst CONFUSABLES: Readonly<Record<string, string>> = {\n  'А': 'A', 'В': 'B', 'Е': 'E', 'К': 'K', 'М': 'M', 'Н': 'H', 'О': 'O', 'Р': 'P', 'С': 'C', 'Т': 'T', 'Х': 'X', 'У': 'Y', 'І': 'I', 'Ј': 'J', 'Ѕ': 'S', 'Ԁ': 'D',\n  'а': 'A', 'в': 'B', 'е': 'E', 'к': 'K', 'м': 'M', 'н': 'H', 'о': 'O', 'р': 'P', 'с': 'C', 'т': 'T', 'х': 'X', 'у': 'Y', 'і': 'I', 'ј': 'J', 'ѕ': 'S', 'ԁ': 'D',\n  'Α': 'A', 'Β': 'B', 'Ε': 'E', 'Ζ': 'Z', 'Η': 'H', 'Ι': 'I', 'Κ': 'K', 'Μ': 'M', 'Ν': 'N', 'Ο': 'O', 'Ρ': 'P', 'Τ': 'T', 'Υ': 'Y', 'Χ': 'X',\n  'α': 'A', 'ε': 'E', 'ι': 'I', 'κ': 'K', 'ν': 'V', 'ο': 'O', 'ρ': 'P', 'τ': 'T', 'υ': 'U', 'χ': 'X',\n  '$': 'S', '₮': 'T', '€': 'E', '¢': 'C', '₿': 'B', 'Ξ': 'E',\n}\n/** Zero-width, bidi and other invisible format characters. */\nconst INVISIBLE = /[­͏؜ᅟᅠ឴឵᠋-᠏​-‏‪-‮⁠-ㅤ︀-️ﾠ]/g\n\n/** A symbol folded the way a reader sees it: invisible characters gone, compatibility forms unified, look-alikes mapped, upper case. */\nexport function foldSymbol(text: string): string {\n  let s = text.replace(INVISIBLE, '').replace(/\\s+/g, '')\n  if (typeof s.normalize === 'function') s = s.normalize('NFKC')\n  // Fullwidth ASCII by hand too: some Hermes builds ship without String.prototype.normalize.\n  s = s.replace(/[\\uFF01-\\uFF5E]/g, (c) => String.fromCharCode(c.charCodeAt(0) - 0xFEE0))\n  let out = ''\n  for (const ch of s) out += CONFUSABLES[ch] ?? ch\n  return out.toUpperCase()\n}\n\n/** Symbols nobody should reuse on any chain: the big stablecoins and wrapped coins (natives are added from the catalog). */\nconst MAJOR_TOKENS = ['USDT', 'USDC', 'DAI', 'USDe', 'USDS', 'PYUSD', 'FDUSD', 'USD1', 'USDG', 'EURC', 'WETH', 'WBTC', 'cbBTC', 'stETH', 'wstETH', 'WSOL']\n\nlet majors: ReadonlyMap<string, string> | undefined\n/** Folded → display: every chain's native coin from the catalog, plus {@link MAJOR_TOKENS}. */\nfunction majorSymbols(): ReadonlyMap<string, string> {\n  if (majors) return majors\n  const m = new Map<string, string>()\n  for (const chain of CC_SOURCE_CHAINS) for (const a of chain.assets) if (!a.contract && !m.has(foldSymbol(a.symbol))) m.set(foldSymbol(a.symbol), a.symbol)\n  for (const sym of MAJOR_TOKENS) if (!m.has(foldSymbol(sym))) m.set(foldSymbol(sym), sym)\n  majors = m\n  return m\n}\n\n/** The known token a folded symbol reads as: any catalog token on the same chain, or a major one anywhere. */\nfunction lookalikeOf(folded: string, chain: string | undefined): string | undefined {\n  if (!folded) return undefined\n  if (chain) {\n    const same = ccChain(catalogChainId(chain))?.assets.find((a) => foldSymbol(a.symbol) === folded)\n    if (same) return same.symbol\n  }\n  return majorSymbols().get(folded)\n}\n\nconst PLAIN = /^[\\x20-\\x7E]*$/\n\n/**\n * Warnings for a token read with `getTokenInfo`, for a token the wallet's list does not include.\n * Pure: nothing is fetched. `impersonation` when its symbol (look-alike letters folded) reads as a\n * catalog token on the same `chain` — the real one would be in the list, this is another contract —\n * or as a native coin or major stablecoin anywhere. A bridged token of another chain's list (JUP on\n * Solana, listed on Unichain) is not flagged.\n */\nexport function assessToken(info: TokenInfo, chain?: string): TokenAssessment {\n  const risks: TokenRisk[] = [{ code: 'unlisted', level: 'caution', message: \"Not in the wallet's token list. Anyone can create a token with any name and logo: check the address with the project itself.\" }]\n  const folded = foldSymbol(info.symbol)\n  const lookalike = lookalikeOf(folded, chain)\n  if (lookalike) {\n    risks.push({ code: 'impersonation', level: 'danger', message: `It calls itself ${JSON.stringify(info.symbol)}, like ${lookalike}, but it is a different token at a different address.` })\n  }\n  if (!PLAIN.test(info.symbol) || !PLAIN.test(info.name) || info.symbol !== info.symbol.replace(INVISIBLE, '') || info.name !== info.name.replace(INVISIBLE, '')) {\n    risks.push({ code: 'odd-characters', level: 'caution', message: 'Its symbol or name uses characters that can look like other letters, or invisible ones.' })\n  }\n  if (!info.symbol.trim()) risks.push({ code: 'no-symbol', level: 'caution', message: 'The token reports no symbol.' })\n  if (info.totalSupply === 0n) risks.push({ code: 'zero-supply', level: 'caution', message: 'Nothing has been minted.' })\n  if (info.decimals > 24) risks.push({ code: 'unusual-decimals', level: 'caution', message: `It uses ${info.decimals} decimals; amounts may display oddly.` })\n  for (const flag of info.flags) {\n    const r = FLAG_RISKS[flag]\n    if (r) risks.push({ code: flag, ...r })\n  }\n  risks.sort((a, b) => (a.level === b.level ? 0 : a.level === 'danger' ? -1 : 1))\n  return { level: risks.some((r) => r.level === 'danger') ? 'danger' : 'caution', risks }\n}\n","import type { IWalletAccountReadOnly, TokenFlag, TokenInfo } from '@anywalletkit/core'\nimport { catalogChainId, ccAssetByToken, isTokenAddress, type CcAsset } from '@anywalletkit/swap2-assets'\nimport { assessToken, type TokenAssessment } from './assess.js'\n\n/** One JSON value under one key — the shape every small store needs (AsyncStorage, chrome.storage, memory). */\nexport interface JsonStorage<T> {\n  /** The stored value, or `null` on first run. */\n  get(): Promise<T | null>\n  /** Persist the value. */\n  set(value: T): Promise<void>\n}\n\n/** In-memory storage for tests and smoke runs. */\nexport function memoryJsonStorage<T>(initial: T | null = null): JsonStorage<T> & { value: T | null } {\n  const clone = (v: T): T => JSON.parse(JSON.stringify(v)) as T\n  const s = {\n    value: initial,\n    async get() { return s.value === null ? null : clone(s.value) },\n    async set(value: T) { s.value = clone(value) },\n  }\n  return s\n}\n\n/** A token the user added. `symbol` and `name` are what the token reports: display them, never match on them. */\nexport interface UserToken {\n  /** CAIP-2 chain id, the catalog's key (`solana:mainnet`, `eip155:1`). */\n  chain: string\n  /** Contract (EVM, checksummed as read) or mint (Solana). The token's identity. */\n  address: string\n  symbol: string\n  name: string\n  decimals: number\n  /** `erc20`, `spl` or `spl-token-2022`. */\n  standard: string\n  /** Facts read from the chain when it was added. */\n  flags: TokenFlag[]\n  /** When the user added it (ms since epoch). */\n  addedAt: number\n}\n\n/** What {@link TokensTable} stores. */\nexport interface TokensState {\n  v: 1\n  tokens: UserToken[]\n}\n\n/** Codes of {@link TokensError}. */\nexport type TokensErrorCode = 'not-loaded' | 'unsupported-chain' | 'bad-address' | 'listed' | 'bad-token' | 'full'\n\n/** A refusal from the tokens table or {@link inspectToken}, with a machine-readable `code`. */\nexport class TokensError extends Error {\n  readonly code: TokensErrorCode\n  constructor(code: TokensErrorCode, message: string) {\n    super(message)\n    this.name = 'TokensError'\n    this.code = code\n  }\n}\n\nconst sameAddress = (chain: string, a: string, b: string) => (chain.startsWith('eip155:') ? a.toLowerCase() === b.toLowerCase() : a === b)\nconst FLAGS: ReadonlySet<string> = new Set<TokenFlag>(['upgradeable', 'mint-authority', 'freeze-authority', 'permanent-delegate', 'transfer-fee', 'transfer-hook', 'non-transferable', 'default-frozen', 'pausable'])\n\n/** A stored entry as it must be, or null (a hand-edited or corrupted entry is dropped, never trusted). */\nfunction validEntry(t: unknown): UserToken | null {\n  if (!t || typeof t !== 'object') return null\n  const e = t as Record<string, unknown>\n  if (typeof e.chain !== 'string' || typeof e.address !== 'string' || !isTokenAddress(e.chain, e.address)) return null\n  if (typeof e.decimals !== 'number' || !Number.isInteger(e.decimals) || e.decimals < 0 || e.decimals > 77) return null\n  if (typeof e.symbol !== 'string' || typeof e.name !== 'string' || typeof e.standard !== 'string' || typeof e.addedAt !== 'number') return null\n  if (!Array.isArray(e.flags) || !e.flags.every((f) => typeof f === 'string' && FLAGS.has(f))) return null\n  return {\n    chain: e.chain, address: e.address, symbol: e.symbol.slice(0, 128), name: e.name.slice(0, 128), decimals: e.decimals,\n    standard: e.standard, flags: [...e.flags] as TokenFlag[], addedAt: e.addedAt,\n  }\n}\n\n/** The result of looking a token up before adding it. */\nexport type TokenInspection =\n  | { listed: CcAsset }\n  | { listed?: undefined; info: TokenInfo; assessment: TokenAssessment; token: UserToken }\n\n/**\n * Read a token from the chain through `account` (its chain decides where) and assess it. A token the\n * catalog already lists comes back as `{ listed }`: nothing to add. Otherwise the token, ready for\n * {@link TokensTable.add}, and the warnings to show first. Throws {@link TokensError}\n * (`unsupported-chain`, `bad-address`) or the chain package's `NotATokenError`.\n */\nexport async function inspectToken(\n  account: Pick<IWalletAccountReadOnly, 'chain' | 'getTokenInfo'> & { getChainId?: () => Promise<number | bigint> },\n  address: string,\n  now: () => number = Date.now,\n): Promise<TokenInspection> {\n  let reported = account.chain\n  // An EVM account created without a chain id reports 'eip155:unknown' until it has asked its RPC:\n  // ask now, or the catalog check (already listed? a look-alike of this chain's tokens?) would miss.\n  if (reported === 'eip155:unknown') {\n    if (typeof account.getChainId !== 'function') throw new TokensError('unsupported-chain', 'The account does not know its chain id; create it with chainId.')\n    reported = `eip155:${String(await account.getChainId())}`\n  }\n  const chain = catalogChainId(reported)\n  if (!chain.startsWith('eip155:') && !chain.startsWith('solana:')) throw new TokensError('unsupported-chain', `Adding tokens is supported on EVM chains and Solana, not ${account.chain}.`)\n  const ref = address.trim()\n  if (!isTokenAddress(chain, ref)) throw new TokensError('bad-address', `${JSON.stringify(address)} is not a token address on ${chain}.`)\n  const listed = ccAssetByToken(chain, ref)\n  if (listed) return { listed }\n  if (typeof account.getTokenInfo !== 'function') throw new TokensError('unsupported-chain', `This ${account.chain} account cannot read token info.`)\n  const info = await account.getTokenInfo(ref)\n  const token: UserToken = {\n    chain, address: info.address, symbol: info.symbol.slice(0, 128), name: info.name.slice(0, 128), decimals: info.decimals,\n    standard: info.standard, flags: [...info.flags], addedAt: now(),\n  }\n  return { info, assessment: assessToken(info, chain), token }\n}\n\n/**\n * The swap options that name a user token as the source: its address and decimals. Pass them to an\n * engine created with `allowUnlistedTokens: true`.\n */\nexport function swapSource(token: Pick<UserToken, 'address' | 'decimals'>): { fromToken: string; fromTokenDecimals: number } {\n  return { fromToken: token.address, fromTokenDecimals: token.decimals }\n}\n\n/**\n * The user's own tokens, over any JSON storage: load once at cold start, then read synchronously.\n * Writes queue behind each other; a failed save leaves memory as stored. Tokens the catalog lists are\n * refused (they are already there), and so are addresses that are not EVM contracts or Solana mints.\n */\nexport class TokensTable {\n  private _state: TokensState | null = null\n  private _loading: Promise<TokensState> | null = null\n  private _writes: Promise<unknown> = Promise.resolve()\n  private readonly listeners = new Set<() => void>()\n  readonly maxTokens: number\n\n  constructor(private readonly storage: JsonStorage<TokensState>, options: { maxTokens?: number } = {}) {\n    this.maxTokens = options.maxTokens ?? 200\n  }\n\n  /** Read the stored list. Call once before the sync reads; a failed read throws and leaves the table unloaded. */\n  async load(): Promise<void> {\n    await this.state()\n  }\n\n  /** Called after every successful write. Returns the unsubscribe function. */\n  subscribe(fn: () => void): () => void {\n    this.listeners.add(fn)\n    return () => { this.listeners.delete(fn) }\n  }\n\n  /** The user's tokens, oldest first; only those on `chain` when given. */\n  list(chain?: string): UserToken[] {\n    const s = this.loaded()\n    const want = chain === undefined ? undefined : catalogChainId(chain)\n    return s.tokens.filter((t) => want === undefined || t.chain === want).map((t) => ({ ...t, flags: [...t.flags] }))\n  }\n\n  /** The user token at `address` on `chain`, if added. */\n  get(chain: string, address: string): UserToken | undefined {\n    const c = catalogChainId(chain)\n    const t = this.loaded().tokens.find((x) => x.chain === c && sameAddress(c, x.address, address))\n    return t ? { ...t, flags: [...t.flags] } : undefined\n  }\n\n  /** Add (or refresh) a token — usually `inspection.token` after the user accepted the warnings. */\n  async add(token: UserToken): Promise<UserToken> {\n    const entry = validEntry({ ...token, chain: catalogChainId(token.chain) })\n    if (!entry) throw new TokensError('bad-token', 'Not a valid token entry (address, decimals 0–77, symbol, name, standard, flags).')\n    if (ccAssetByToken(entry.chain, entry.address)) throw new TokensError('listed', `${entry.address} is already in the wallet's token list.`)\n    await this.update((s) => {\n      const rest = s.tokens.filter((t) => !(t.chain === entry.chain && sameAddress(entry.chain, t.address, entry.address)))\n      if (rest.length >= this.maxTokens) throw new TokensError('full', `At most ${this.maxTokens} tokens can be added.`)\n      return { v: 1, tokens: [...rest, entry] }\n    })\n    return { ...entry, flags: [...entry.flags] }\n  }\n\n  /** Remove a token. Returns whether it was there. */\n  async remove(chain: string, address: string): Promise<boolean> {\n    const c = catalogChainId(chain)\n    let removed = false\n    await this.update((s) => {\n      const rest = s.tokens.filter((t) => !(t.chain === c && sameAddress(c, t.address, address)))\n      removed = rest.length !== s.tokens.length\n      return { v: 1, tokens: rest }\n    })\n    return removed\n  }\n\n  private loaded(): TokensState {\n    if (!this._state) throw new TokensError('not-loaded', 'Call load() before reading the tokens table.')\n    return this._state\n  }\n\n  private async state(): Promise<TokensState> {\n    if (this._state) return this._state\n    this._loading ??= (async () => {\n      let stored: TokensState | null\n      try {\n        stored = await this.storage.get()\n      } catch (e) {\n        // A failed read is not an empty list: the next write would erase the user's tokens.\n        this._loading = null\n        throw e\n      }\n      const tokens = stored && stored.v === 1 && Array.isArray(stored.tokens)\n        ? stored.tokens.map(validEntry).filter((t): t is UserToken => t !== null)\n        : []\n      this._state = { v: 1, tokens }\n      return this._state\n    })()\n    return this._loading\n  }\n\n  private update(change: (s: TokensState) => TokensState): Promise<void> {\n    const run = this._writes.then(async () => {\n      const next = change(await this.state())\n      await this.storage.set(next)\n      this._state = next\n      for (const fn of this.listeners) {\n        try { fn() } catch { /* a listener's failure is its own */ }\n      }\n    })\n    this._writes = run.catch(() => undefined)\n    return run\n  }\n}\n"],"mappings":"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","names":["catalogChainId","catalogChainId"]}