@usebutr/svm 0.2.0 → 0.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/package.json +3 -3
package/dist/index.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
import{logWarn as e}from"@usebutr/core";import{buildAccount as
|
|
1
|
+
import{logWarn as e,sanitizeIcon as t}from"@usebutr/core";import{buildAccount as n,discoverWalletStandard as r,getFeature as i,pickAccountByAddress as a,pickFirstAddress as o,slugify as s}from"@usebutr/wallet-standard-shared";const c=e=>({getBalance:!1,getTransactionReceipt:!1,requestAccounts:!1,sendTransaction:e.features.signAndSendTransaction,signIn:e.features.signIn,signMessage:e.features.signMessage,signTransaction:e.features.signTransaction,subscribe:e.features.events,switchAccount:!1,switchChain:e.chainCount>1}),l=`solana:`,u=e=>{let t=``;for(let n of e)t+=String.fromCodePoint(n);return btoa(t)},d=e=>s(`svm`,e),f=e=>e.chains.find(e=>e===`solana:mainnet`||e===`solana:mainnet-beta`)||(e.chains.find(e=>e.startsWith(l))??null),p=(e,t)=>({id:e,name:t,namespace:`solana`,reference:e.slice(7)}),m=(e,t)=>n(e,t),h=(n,r)=>{let s=f(n);if(!s)return null;let h=i(n,`standard:connect`);if(!h)return null;let g=i(n,`standard:disconnect`),_=i(n,`standard:events`),v=i(n,`solana:signMessage`),y=i(n,`solana:signAndSendTransaction`),b=i(n,`solana:signTransaction`),x=i(n,`solana:signIn`),S=s,C=()=>p(S,n.name),w=new Set,T=()=>{if(n.accounts.length===0)return;let e=C(),t=n.accounts.map(t=>m(t.address,e)),r=t[0];if(r)for(let e of w)e({account:r,accounts:t,type:`accountChanged`})};return r?.(()=>{for(let e of w)e({type:`disconnected`})}),{capabilities:c({chainCount:n.chains.length,features:{events:!!_,signAndSendTransaction:!!y,signIn:!!x,signMessage:!!v,signTransaction:!!b}}),chainPlatform:`svm`,async connect(e){await h.connect(e?.silent?{silent:!0}:void 0)},async disconnect(){if(g)try{await g.disconnect()}catch(t){e(`[butr] Wallet Standard disconnect threw:`,t)}},getAccount(){let e=o(n.accounts);return e?Promise.resolve(m(e,C())):Promise.resolve(null)},getAccounts(){let e=C();return Promise.resolve(n.accounts.map(t=>m(t.address,e)))},getBalance(){return Promise.resolve({decimals:9,formatted:`0`,symbol:`SOL`,value:0n})},getSigner(){return Promise.resolve(n)},getTransactionReceipt(){return Promise.resolve({status:`Pending`})},icon:t(n.icon),id:d(n.name),name:n.name,async requestAccounts(){await h.connect()},async sendTx(e,t){if(!y)throw Error(`Wallet ${n.name} does not advertise solana:signAndSendTransaction`);let r=t?a(n.accounts,t.walletAddress):n.accounts[0]??null;if(!r)throw Error(`No connected account`);if(!(e instanceof Uint8Array))throw TypeError(`SVM sendTx expects a serialized transaction (Uint8Array)`);let[i]=await y.signAndSendTransaction({account:r,chain:S,transaction:e});if(!i)throw Error(`signAndSendTransaction returned no outputs`);return u(i.signature)},sendTxToChain(e,t,n,r){return r?.(),this.sendTx(e,n)},async signMessage(e,t){if(!v)throw Error(`Wallet ${n.name} does not advertise solana:signMessage`);let r=t?a(n.accounts,t.walletAddress):n.accounts[0]??null;if(!r)throw Error(`No connected account`);let[i]=await v.signMessage({account:r,message:e});if(!i)throw Error(`signMessage returned no outputs`);return{signature:i.signature,signedMessage:i.signedMessage}},...b?{async signTransaction(e,t){let r=t?a(n.accounts,t.walletAddress):n.accounts[0]??null;if(!r)throw Error(`No connected account`);if(!(e instanceof Uint8Array))throw TypeError(`SVM signTransaction expects a serialized transaction (Uint8Array)`);let[i]=await b.signTransaction({account:r,chain:S,transaction:e});if(!i)throw Error(`signTransaction returned no outputs`);return i.signedTransaction}}:{},...x?{async signIn(e){let[t]=await x.signIn(e);if(!t)throw Error(`signIn returned no outputs`);return{account:m(t.account.address,C()),signature:t.signature,signedMessage:t.signedMessage}}}:{},subscribe(e){w.add(e);let t=null;if(_){let n=_.on(`change`,t=>{if(t.chains){let e=t.chains.find(e=>e===`solana:mainnet`||e===`solana:mainnet-beta`)??t.chains.find(e=>e.startsWith(l));e&&(S=e)}if(t.accounts){if(t.accounts.length===0){e({type:`disconnected`});return}let n=C(),r=t.accounts.map(e=>m(e.address,n)),i=r[0];if(!i)return;e({account:i,accounts:r,type:`accountChanged`});return}t.chains&&T()});t=()=>n()}return()=>{w.delete(e),t?.()}},switchChain(e){if(e.namespace!==`solana`)throw Error(`SVM adapter received non-Solana chain "${e.id}". Pass a chain with namespace "solana".`);if(!n.chains.includes(e.id))throw Error(`Wallet ${n.name} does not advertise chain "${e.id}". Available: ${n.chains.join(`, `)}`);return S=e.id,T(),Promise.resolve()}}},g=e=>r(e,(e,t)=>h(e,t)),_={devnet:{id:`solana:devnet`,name:`Solana Devnet`,namespace:`solana`,reference:`devnet`},mainnet:{id:`solana:mainnet`,name:`Solana Mainnet`,namespace:`solana`,reference:`mainnet`},testnet:{id:`solana:testnet`,name:`Solana Testnet`,namespace:`solana`,reference:`testnet`}},v=Object.values(_),y={platform:`svm`,subscribe:g};export{_ as SVM_CHAINS,v as SVM_CHAINS_LIST,h as buildSvmAdapter,g as discoverSvmAdapters,c as resolveWalletStandardCapabilities,d as slugify,y as svmDiscoverer};
|
|
2
2
|
//# sourceMappingURL=index.js.map
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","names":["kitSlugify"],"sources":["../src/capabilities.ts","../src/wallet-standard-adapter.ts","../src/wallet-standard.ts","../src/chains.ts","../src/discoverer.ts"],"sourcesContent":["import type { WalletCapabilities } from \"@usebutr/core\";\n\ntype WalletStandardCapabilityInput = {\n chainCount: number;\n features: {\n events: boolean;\n signAndSendTransaction: boolean;\n signIn: boolean;\n signMessage: boolean;\n signTransaction: boolean;\n };\n};\n\n/**\n * Wallet Standard capability mapping.\n *\n * - `getBalance` / `getTransactionReceipt`: Wallet Standard exposes no\n * balance/receipt RPC.\n * - `requestAccounts`: no programmatic equivalent of EIP-2255 — re-running\n * `standard:connect` doesn't produce new accounts on any major Wallet\n * Standard wallet in practice (Phantom Solana, MetaMask Snap, Solflare,\n * Backpack).\n * - `switchChain`: true when more than one chain is advertised; with a\n * single chain there's nothing to switch to.\n */\nconst resolveWalletStandardCapabilities = (\n input: WalletStandardCapabilityInput,\n): WalletCapabilities => ({\n getBalance: false,\n getTransactionReceipt: false,\n requestAccounts: false,\n sendTransaction: input.features.signAndSendTransaction,\n signIn: input.features.signIn,\n signMessage: input.features.signMessage,\n signTransaction: input.features.signTransaction,\n subscribe: input.features.events,\n switchAccount: false,\n switchChain: input.chainCount > 1,\n});\n\nexport type { WalletStandardCapabilityInput };\nexport { resolveWalletStandardCapabilities };\n","import type { Account, ChainBase, ConnectorEvent, WalletAdapter } from \"@usebutr/core\";\nimport { logWarn } from \"@usebutr/core\";\nimport {\n buildAccount,\n getFeature,\n pickAccountByAddress,\n pickFirstAddress,\n slugify as kitSlugify,\n} from \"@usebutr/wallet-standard-shared\";\nimport type {\n StandardConnectFeature,\n StandardDisconnectFeature,\n StandardEventsFeature,\n WalletStandardWallet,\n} from \"@usebutr/wallet-standard-shared\";\n\nimport { resolveWalletStandardCapabilities } from \"./capabilities\";\nimport type {\n SolanaSignAndSendTransactionFeature,\n SolanaSignInFeature,\n SolanaSignMessageFeature,\n SolanaSignTransactionFeature,\n} from \"./wallet-standard-types\";\n\nconst SOLANA_PREFIX = \"solana:\";\nconst SOLANA_DECIMALS = 9;\n\n/** Cross-platform Uint8Array → base64. `Buffer` would be Node-only and\n * breaks the package in browsers without a polyfill. `btoa` is\n * available everywhere butr runs (browsers, RN since Hermes, Node 16+,\n * Bun, Deno). */\nconst bytesToBase64 = (bytes: Uint8Array): string => {\n let binary = \"\";\n for (const byte of bytes) {\n binary += String.fromCodePoint(byte);\n }\n return btoa(binary);\n};\n\nconst slugify = (name: string): string => kitSlugify(\"svm\", name);\n\nconst pickSolanaChain = (wallet: WalletStandardWallet): string | null => {\n // Prefer mainnet-beta, then the first solana chain advertised.\n const mainnet = wallet.chains.find((c) => c === \"solana:mainnet\" || c === \"solana:mainnet-beta\");\n if (mainnet) {\n return mainnet;\n }\n return wallet.chains.find((c) => c.startsWith(SOLANA_PREFIX)) ?? null;\n};\n\nconst buildSolanaChain = (chainId: string, walletName: string): ChainBase => ({\n id: chainId,\n // Same stance as the EIP-6963 side: we don't ship a chain-id → name\n // table. Consumers overlay via structural typing.\n name: walletName,\n namespace: \"solana\",\n reference: chainId.slice(SOLANA_PREFIX.length),\n});\n\nconst buildSolanaAccount = (address: string, chain: ChainBase): Account =>\n buildAccount(address, chain);\n\n/**\n * Adapt a Solana Wallet Standard `Wallet` object into a butr\n * `WalletAdapter`. Returns `null` if the wallet doesn't advertise any\n * Solana chain or doesn't expose `standard:connect` — both required\n * for butr to do anything useful with it.\n *\n * **Capability gating**\n *\n * - `signMessage` is only present if the wallet advertises\n * `solana:signMessage`. Without it, calling `adapter.signMessage`\n * rejects with a clear error.\n * - `sendTx` / `sendTxToChain` use `solana:signAndSendTransaction`.\n * Without it, those methods reject.\n * - `subscribe` is wired through `standard:events`. Wallets that\n * don't expose events get a no-op unsubscribe.\n *\n * **Known limitations**\n *\n * - `getBalance` returns `{ value: 0n, formatted: \"0\", … }`. Solana\n * balance reads require an RPC connection that's outside butr's\n * scope; consumers wrap their own RPC client.\n * - `getTransactionReceipt` returns `{ status: \"Pending\" }`. Same\n * reason — needs an RPC.\n * - `switchChain` updates butr's view of the current Solana cluster\n * locally and routes subsequent `signAndSendTransaction` calls\n * through the new chain. Wallet Standard has no \"tell the wallet\n * to switch cluster\" RPC; the wallet's own UI controls its global\n * cluster setting, and `signAndSendTransaction` accepts the chain\n * per-call. The chain must be one the wallet advertises in\n * `wallet.chains`; otherwise the call rejects.\n * - `requestAccounts` re-runs `standard:connect`. Some wallets show\n * their account picker again; others (those that \"remember\"\n * authorisations) silently return the existing accounts. butr\n * refreshes the pool entry's `accounts` array either way.\n * - `switchAccount` is intentionally unimplemented. Wallet Standard\n * has no silent \"use address X\" feature — the user picks the active\n * account through the wallet's own UI. `signAndSendTransaction`\n * accepts an `account` input, so consumers needing per-tx address\n * selection can pick one from `accounts` at call time.\n */\nconst buildSvmAdapter = (\n wallet: WalletStandardWallet,\n /** Optional. Called with a function that pushes a synthetic\n * `disconnected` event to all current subscribers. The discovery\n * layer invokes it on Wallet Standard `unregister` so a connected\n * pool entry tears down when its extension is removed. */\n registerDisconnector?: (emit: () => void) => void,\n): WalletAdapter | null => {\n const solanaChainId = pickSolanaChain(wallet);\n if (!solanaChainId) {\n return null;\n }\n const connect = getFeature<StandardConnectFeature>(wallet, \"standard:connect\");\n if (!connect) {\n return null;\n }\n\n const disconnect = getFeature<StandardDisconnectFeature>(wallet, \"standard:disconnect\");\n const events = getFeature<StandardEventsFeature>(wallet, \"standard:events\");\n const signMessage = getFeature<SolanaSignMessageFeature>(wallet, \"solana:signMessage\");\n const signAndSendTx = getFeature<SolanaSignAndSendTransactionFeature>(\n wallet,\n \"solana:signAndSendTransaction\",\n );\n const signTx = getFeature<SolanaSignTransactionFeature>(wallet, \"solana:signTransaction\");\n const signIn = getFeature<SolanaSignInFeature>(wallet, \"solana:signIn\");\n\n // Current Solana cluster. Mutable so `switchChain` can route subsequent\n // `signAndSendTransaction` calls through a different cluster without\n // rebuilding the adapter. butr's reducer learns about chain changes\n // via the `accountChanged` events emitted to subscribers below.\n let currentChainId = solanaChainId;\n const currentChain = (): ChainBase => buildSolanaChain(currentChainId, wallet.name);\n\n // Local listener set so `switchChain` (and `requestAccounts`) can\n // synthesise `accountChanged` events that flow into butr's pool.\n // Wallet-native events from `standard:events` are bridged alongside.\n const listeners = new Set<(event: ConnectorEvent) => void>();\n const notifyAccountChanged = () => {\n if (wallet.accounts.length === 0) {\n return;\n }\n const chain = currentChain();\n const built = wallet.accounts.map((a) => buildSolanaAccount(a.address, chain));\n const first = built[0];\n if (!first) {\n return;\n }\n for (const listener of listeners) {\n listener({ account: first, accounts: built, type: \"accountChanged\" });\n }\n };\n\n registerDisconnector?.(() => {\n for (const listener of listeners) {\n listener({ type: \"disconnected\" });\n }\n });\n\n return {\n capabilities: resolveWalletStandardCapabilities({\n chainCount: wallet.chains.length,\n features: {\n events: Boolean(events),\n signAndSendTransaction: Boolean(signAndSendTx),\n signIn: Boolean(signIn),\n signMessage: Boolean(signMessage),\n signTransaction: Boolean(signTx),\n },\n }),\n chainPlatform: \"svm\",\n\n async connect(opts) {\n // Forward `silent` so eager hydration restores already-authorized\n // accounts without re-opening the wallet's approval UI. Wallets\n // that don't honour `silent` fall back to their normal behaviour.\n await connect.connect(opts?.silent ? { silent: true } : undefined);\n },\n\n async disconnect() {\n if (disconnect) {\n try {\n await disconnect.disconnect();\n } catch (error) {\n logWarn(\"[butr] Wallet Standard disconnect threw:\", error);\n }\n }\n },\n\n getAccount() {\n const address = pickFirstAddress(wallet.accounts);\n if (!address) {\n return Promise.resolve(null);\n }\n return Promise.resolve(buildSolanaAccount(address, currentChain()));\n },\n\n getAccounts() {\n const chain = currentChain();\n return Promise.resolve(wallet.accounts.map((a) => buildSolanaAccount(a.address, chain)));\n },\n\n getBalance() {\n // Wallet Standard exposes no balance feature. Consumers wrap\n // their own RPC client; this default keeps the type signature\n // honoured without lying about a value we don't have.\n return Promise.resolve({\n decimals: SOLANA_DECIMALS,\n formatted: \"0\",\n symbol: \"SOL\",\n value: 0n,\n });\n },\n\n getSigner() {\n // Consumers cast to their preferred wrapper (e.g. an Anchor\n // provider built around the wallet's signTransaction feature).\n return Promise.resolve(wallet);\n },\n\n getTransactionReceipt() {\n // Same reason as `getBalance` — no RPC.\n return Promise.resolve({ status: \"Pending\" as const });\n },\n\n icon: wallet.icon,\n id: slugify(wallet.name),\n name: wallet.name,\n\n async requestAccounts() {\n // Wallet Standard has no equivalent of EIP-2255's\n // `wallet_requestPermissions`. The closest we can do is re-run\n // `standard:connect`, which prompts the user on wallets that\n // surface their picker each time and silently returns the\n // existing list on wallets that remember authorisations.\n // butr's runtime calls `getAccounts()` afterwards to refresh\n // the pool entry, so newly-exposed addresses appear either way.\n await connect.connect();\n },\n\n async sendTx(tx, account) {\n if (!signAndSendTx) {\n throw new Error(`Wallet ${wallet.name} does not advertise solana:signAndSendTransaction`);\n }\n const wsAccount = account\n ? pickAccountByAddress(wallet.accounts, account.walletAddress)\n : (wallet.accounts[0] ?? null);\n if (!wsAccount) {\n throw new Error(\"No connected account\");\n }\n if (!(tx instanceof Uint8Array)) {\n throw new TypeError(\"SVM sendTx expects a serialized transaction (Uint8Array)\");\n }\n const [output] = await signAndSendTx.signAndSendTransaction({\n account: wsAccount,\n chain: currentChainId,\n transaction: tx,\n });\n if (!output) {\n throw new Error(\"signAndSendTransaction returned no outputs\");\n }\n return bytesToBase64(output.signature);\n },\n\n sendTxToChain(tx, _targetChainId, account, cb) {\n // Solana Wallet Standard's signAndSendTransaction takes the\n // target chain directly. `targetChainId` is the decimal-string\n // form butr uses, but the wallet expects a CAIP-2 chain string.\n // For now we honour the connector's primary `solanaChainId` and\n // let consumers route per-chain at a higher level if they need\n // multi-cluster support.\n cb?.();\n return this.sendTx(tx, account);\n },\n\n async signMessage(msg, account) {\n if (!signMessage) {\n throw new Error(`Wallet ${wallet.name} does not advertise solana:signMessage`);\n }\n const wsAccount = account\n ? pickAccountByAddress(wallet.accounts, account.walletAddress)\n : (wallet.accounts[0] ?? null);\n if (!wsAccount) {\n throw new Error(\"No connected account\");\n }\n const [output] = await signMessage.signMessage({ account: wsAccount, message: msg });\n if (!output) {\n throw new Error(\"signMessage returned no outputs\");\n }\n return { signature: output.signature, signedMessage: output.signedMessage };\n },\n\n ...(signTx\n ? {\n async signTransaction(tx, account) {\n // Sign-only path for wallets without\n // solana:signAndSendTransaction. butr ships no RPC, so the\n // caller broadcasts the returned bytes with their own\n // client. Gated by capabilities.signTransaction.\n const wsAccount = account\n ? pickAccountByAddress(wallet.accounts, account.walletAddress)\n : (wallet.accounts[0] ?? null);\n if (!wsAccount) {\n throw new Error(\"No connected account\");\n }\n if (!(tx instanceof Uint8Array)) {\n throw new TypeError(\n \"SVM signTransaction expects a serialized transaction (Uint8Array)\",\n );\n }\n const [output] = await signTx.signTransaction({\n account: wsAccount,\n chain: currentChainId,\n transaction: tx,\n });\n if (!output) {\n throw new Error(\"signTransaction returned no outputs\");\n }\n return output.signedTransaction;\n },\n }\n : {}),\n\n ...(signIn\n ? {\n async signIn(input) {\n // Sign In With Solana. Returns the authenticated account\n // plus the signed statement for server-side verification.\n const [output] = await signIn.signIn(input);\n if (!output) {\n throw new Error(\"signIn returned no outputs\");\n }\n return {\n account: buildSolanaAccount(output.account.address, currentChain()),\n signature: output.signature,\n signedMessage: output.signedMessage,\n };\n },\n }\n : {}),\n\n subscribe(listener) {\n listeners.add(listener);\n let unsubWallet: (() => void) | null = null;\n if (events) {\n const unsub = events.on(\"change\", (changes) => {\n // Chain change: the wallet switched cluster. Re-point\n // currentChainId so subsequent signAndSendTransaction routes\n // through it, mirroring `switchChain`'s local-state model.\n if (changes.chains) {\n const next =\n changes.chains.find((c) => c === \"solana:mainnet\" || c === \"solana:mainnet-beta\") ??\n changes.chains.find((c) => c.startsWith(SOLANA_PREFIX));\n if (next) {\n currentChainId = next;\n }\n }\n\n if (changes.accounts) {\n if (changes.accounts.length === 0) {\n listener({ type: \"disconnected\" });\n return;\n }\n // Forward the FULL accounts list — Wallet Standard's\n // change.accounts reflects the wallet's current exposure\n // set. Mirroring it into the pool entry keeps the array in\n // sync with what the wallet actually allows us to sign with,\n // so single-account-exposure wallets (Phantom Solana,\n // MetaMask Snap) don't accumulate stale addresses.\n const chain = currentChain();\n const built = changes.accounts.map((a) => buildSolanaAccount(a.address, chain));\n const first = built[0];\n if (!first) {\n return;\n }\n listener({ account: first, accounts: built, type: \"accountChanged\" });\n return;\n }\n\n // Chains changed without an accounts change — still push the\n // new chain into the pool entry via the same path switchChain\n // uses, so consumers see the cluster swap.\n if (changes.chains) {\n notifyAccountChanged();\n }\n });\n unsubWallet = () => unsub();\n }\n return () => {\n listeners.delete(listener);\n unsubWallet?.();\n };\n },\n\n switchChain(chain) {\n if (chain.namespace !== \"solana\") {\n throw new Error(\n `SVM adapter received non-Solana chain \"${chain.id}\". Pass a chain with namespace \"solana\".`,\n );\n }\n // The wallet must advertise this cluster — otherwise\n // signAndSendTransaction will reject the chain string later.\n if (!wallet.chains.includes(chain.id)) {\n throw new Error(\n `Wallet ${wallet.name} does not advertise chain \"${chain.id}\". Available: ${wallet.chains.join(\", \")}`,\n );\n }\n currentChainId = chain.id;\n // Synthesise an `accountChanged` so butr's reducer updates the\n // pool entry's chain — the wallet itself has no event to fire here.\n notifyAccountChanged();\n return Promise.resolve();\n },\n };\n};\n\nexport { buildSvmAdapter, slugify };\n","import type { WalletAdapter } from \"@usebutr/core\";\nimport { discoverWalletStandard } from \"@usebutr/wallet-standard-shared\";\n\nimport { buildSvmAdapter } from \"./wallet-standard-adapter\";\n\n/**\n * Subscribe to Solana Wallet Standard announcements.\n * Spec: https://github.com/wallet-standard/wallet-standard\n *\n * Runtime requires the `@wallet-standard/app` package, which is an\n * **optional peer dependency** of butr. EVM-only consumers don't need\n * to install it — discovery will silently skip the SVM side if the\n * module isn't resolvable.\n *\n * Install for SVM auto-discovery:\n *\n * npm install @wallet-standard/app\n *\n * The function returns a synchronous unsubscribe that's safe to call\n * before the dynamic import has resolved.\n *\n * Implementation: the discovery loop (dynamic import, dedupe, register\n * / unregister bridge) lives in `@usebutr/wallet-standard-shared`. This\n * file's only job is to hand the kit a per-wallet builder.\n */\nconst discoverSvmAdapters = (onAdapter: (adapter: WalletAdapter) => void): (() => void) =>\n discoverWalletStandard(onAdapter, (wallet, registerDisconnector) =>\n buildSvmAdapter(wallet, registerDisconnector),\n );\n\nexport { discoverSvmAdapters };\n","import type { ChainBase } from \"@usebutr/core\";\n\n// Solana chain identifiers follow the Wallet Standard convention\n// (`solana:mainnet` / `solana:devnet` / `solana:testnet`) rather than\n// the strict CAIP-2 genesis-hash form (`solana:5eykt…`). Phantom,\n// Solflare, Backpack and the rest of the Wallet Standard ecosystem\n// advertise these shortnames in `wallet.chains`, and the SVM adapter's\n// `switchChain` rejects anything not in that set. The genesis-hash form\n// remains valid CAIP-2 but isn't what real wallets exchange.\nconst SVM_CHAINS = {\n devnet: { id: \"solana:devnet\", name: \"Solana Devnet\", namespace: \"solana\", reference: \"devnet\" },\n mainnet: {\n id: \"solana:mainnet\",\n name: \"Solana Mainnet\",\n namespace: \"solana\",\n reference: \"mainnet\",\n },\n testnet: {\n id: \"solana:testnet\",\n name: \"Solana Testnet\",\n namespace: \"solana\",\n reference: \"testnet\",\n },\n} as const satisfies Record<string, ChainBase>;\n\nconst SVM_CHAINS_LIST: ReadonlyArray<ChainBase> = Object.values(SVM_CHAINS);\n\nexport { SVM_CHAINS, SVM_CHAINS_LIST };\n","import type { PlatformDiscoverer } from \"@usebutr/core\";\n\nimport { discoverSvmAdapters } from \"./wallet-standard\";\n\n/**\n * SVM's `PlatformDiscoverer`: Solana Wallet Standard announcements. No\n * legacy fallback — Solana wallets standardised on Wallet Standard\n * before butr existed, so there's no `window.solana` injected path\n * worth shimming.\n */\nconst svmDiscoverer: PlatformDiscoverer = {\n platform: \"svm\",\n subscribe: discoverSvmAdapters,\n};\n\nexport { svmDiscoverer };\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"index.js","names":["kitSlugify"],"sources":["../src/capabilities.ts","../src/wallet-standard-adapter.ts","../src/wallet-standard.ts","../src/chains.ts","../src/discoverer.ts"],"sourcesContent":["import type { WalletCapabilities } from \"@usebutr/core\";\n\ntype WalletStandardCapabilityInput = {\n chainCount: number;\n features: {\n events: boolean;\n signAndSendTransaction: boolean;\n signIn: boolean;\n signMessage: boolean;\n signTransaction: boolean;\n };\n};\n\n/**\n * Wallet Standard capability mapping.\n *\n * - `getBalance` / `getTransactionReceipt`: Wallet Standard exposes no\n * balance/receipt RPC.\n * - `requestAccounts`: no programmatic equivalent of EIP-2255 — re-running\n * `standard:connect` doesn't produce new accounts on any major Wallet\n * Standard wallet in practice (Phantom Solana, MetaMask Snap, Solflare,\n * Backpack).\n * - `switchChain`: true when more than one chain is advertised; with a\n * single chain there's nothing to switch to.\n */\nconst resolveWalletStandardCapabilities = (\n input: WalletStandardCapabilityInput,\n): WalletCapabilities => ({\n getBalance: false,\n getTransactionReceipt: false,\n requestAccounts: false,\n sendTransaction: input.features.signAndSendTransaction,\n signIn: input.features.signIn,\n signMessage: input.features.signMessage,\n signTransaction: input.features.signTransaction,\n subscribe: input.features.events,\n switchAccount: false,\n switchChain: input.chainCount > 1,\n});\n\nexport type { WalletStandardCapabilityInput };\nexport { resolveWalletStandardCapabilities };\n","import type { Account, ChainBase, ConnectorEvent, WalletAdapter } from \"@usebutr/core\";\nimport { logWarn, sanitizeIcon } from \"@usebutr/core\";\nimport {\n buildAccount,\n getFeature,\n pickAccountByAddress,\n pickFirstAddress,\n slugify as kitSlugify,\n} from \"@usebutr/wallet-standard-shared\";\nimport type {\n StandardConnectFeature,\n StandardDisconnectFeature,\n StandardEventsFeature,\n WalletStandardWallet,\n} from \"@usebutr/wallet-standard-shared\";\n\nimport { resolveWalletStandardCapabilities } from \"./capabilities\";\nimport type {\n SolanaSignAndSendTransactionFeature,\n SolanaSignInFeature,\n SolanaSignMessageFeature,\n SolanaSignTransactionFeature,\n} from \"./wallet-standard-types\";\n\nconst SOLANA_PREFIX = \"solana:\";\nconst SOLANA_DECIMALS = 9;\n\n/** Cross-platform Uint8Array → base64. `Buffer` would be Node-only and\n * breaks the package in browsers without a polyfill. `btoa` is\n * available everywhere butr runs (browsers, RN since Hermes, Node 16+,\n * Bun, Deno). */\nconst bytesToBase64 = (bytes: Uint8Array): string => {\n let binary = \"\";\n for (const byte of bytes) {\n binary += String.fromCodePoint(byte);\n }\n return btoa(binary);\n};\n\nconst slugify = (name: string): string => kitSlugify(\"svm\", name);\n\nconst pickSolanaChain = (wallet: WalletStandardWallet): string | null => {\n // Prefer mainnet-beta, then the first solana chain advertised.\n const mainnet = wallet.chains.find((c) => c === \"solana:mainnet\" || c === \"solana:mainnet-beta\");\n if (mainnet) {\n return mainnet;\n }\n return wallet.chains.find((c) => c.startsWith(SOLANA_PREFIX)) ?? null;\n};\n\nconst buildSolanaChain = (chainId: string, walletName: string): ChainBase => ({\n id: chainId,\n // Same stance as the EIP-6963 side: we don't ship a chain-id → name\n // table. Consumers overlay via structural typing.\n name: walletName,\n namespace: \"solana\",\n reference: chainId.slice(SOLANA_PREFIX.length),\n});\n\nconst buildSolanaAccount = (address: string, chain: ChainBase): Account =>\n buildAccount(address, chain);\n\n/**\n * Adapt a Solana Wallet Standard `Wallet` object into a butr\n * `WalletAdapter`. Returns `null` if the wallet doesn't advertise any\n * Solana chain or doesn't expose `standard:connect` — both required\n * for butr to do anything useful with it.\n *\n * **Capability gating**\n *\n * - `signMessage` is only present if the wallet advertises\n * `solana:signMessage`. Without it, calling `adapter.signMessage`\n * rejects with a clear error.\n * - `sendTx` / `sendTxToChain` use `solana:signAndSendTransaction`.\n * Without it, those methods reject.\n * - `subscribe` is wired through `standard:events`. Wallets that\n * don't expose events get a no-op unsubscribe.\n *\n * **Known limitations**\n *\n * - `getBalance` returns `{ value: 0n, formatted: \"0\", … }`. Solana\n * balance reads require an RPC connection that's outside butr's\n * scope; consumers wrap their own RPC client.\n * - `getTransactionReceipt` returns `{ status: \"Pending\" }`. Same\n * reason — needs an RPC.\n * - `switchChain` updates butr's view of the current Solana cluster\n * locally and routes subsequent `signAndSendTransaction` calls\n * through the new chain. Wallet Standard has no \"tell the wallet\n * to switch cluster\" RPC; the wallet's own UI controls its global\n * cluster setting, and `signAndSendTransaction` accepts the chain\n * per-call. The chain must be one the wallet advertises in\n * `wallet.chains`; otherwise the call rejects.\n * - `requestAccounts` re-runs `standard:connect`. Some wallets show\n * their account picker again; others (those that \"remember\"\n * authorisations) silently return the existing accounts. butr\n * refreshes the pool entry's `accounts` array either way.\n * - `switchAccount` is intentionally unimplemented. Wallet Standard\n * has no silent \"use address X\" feature — the user picks the active\n * account through the wallet's own UI. `signAndSendTransaction`\n * accepts an `account` input, so consumers needing per-tx address\n * selection can pick one from `accounts` at call time.\n */\nconst buildSvmAdapter = (\n wallet: WalletStandardWallet,\n /** Optional. Called with a function that pushes a synthetic\n * `disconnected` event to all current subscribers. The discovery\n * layer invokes it on Wallet Standard `unregister` so a connected\n * pool entry tears down when its extension is removed. */\n registerDisconnector?: (emit: () => void) => void,\n): WalletAdapter | null => {\n const solanaChainId = pickSolanaChain(wallet);\n if (!solanaChainId) {\n return null;\n }\n const connect = getFeature<StandardConnectFeature>(wallet, \"standard:connect\");\n if (!connect) {\n return null;\n }\n\n const disconnect = getFeature<StandardDisconnectFeature>(wallet, \"standard:disconnect\");\n const events = getFeature<StandardEventsFeature>(wallet, \"standard:events\");\n const signMessage = getFeature<SolanaSignMessageFeature>(wallet, \"solana:signMessage\");\n const signAndSendTx = getFeature<SolanaSignAndSendTransactionFeature>(\n wallet,\n \"solana:signAndSendTransaction\",\n );\n const signTx = getFeature<SolanaSignTransactionFeature>(wallet, \"solana:signTransaction\");\n const signIn = getFeature<SolanaSignInFeature>(wallet, \"solana:signIn\");\n\n // Current Solana cluster. Mutable so `switchChain` can route subsequent\n // `signAndSendTransaction` calls through a different cluster without\n // rebuilding the adapter. butr's reducer learns about chain changes\n // via the `accountChanged` events emitted to subscribers below.\n let currentChainId = solanaChainId;\n const currentChain = (): ChainBase => buildSolanaChain(currentChainId, wallet.name);\n\n // Local listener set so `switchChain` (and `requestAccounts`) can\n // synthesise `accountChanged` events that flow into butr's pool.\n // Wallet-native events from `standard:events` are bridged alongside.\n const listeners = new Set<(event: ConnectorEvent) => void>();\n const notifyAccountChanged = () => {\n if (wallet.accounts.length === 0) {\n return;\n }\n const chain = currentChain();\n const built = wallet.accounts.map((a) => buildSolanaAccount(a.address, chain));\n const first = built[0];\n if (!first) {\n return;\n }\n for (const listener of listeners) {\n listener({ account: first, accounts: built, type: \"accountChanged\" });\n }\n };\n\n registerDisconnector?.(() => {\n for (const listener of listeners) {\n listener({ type: \"disconnected\" });\n }\n });\n\n return {\n capabilities: resolveWalletStandardCapabilities({\n chainCount: wallet.chains.length,\n features: {\n events: Boolean(events),\n signAndSendTransaction: Boolean(signAndSendTx),\n signIn: Boolean(signIn),\n signMessage: Boolean(signMessage),\n signTransaction: Boolean(signTx),\n },\n }),\n chainPlatform: \"svm\",\n\n async connect(opts) {\n // Forward `silent` so eager hydration restores already-authorized\n // accounts without re-opening the wallet's approval UI. Wallets\n // that don't honour `silent` fall back to their normal behaviour.\n await connect.connect(opts?.silent ? { silent: true } : undefined);\n },\n\n async disconnect() {\n if (disconnect) {\n try {\n await disconnect.disconnect();\n } catch (error) {\n logWarn(\"[butr] Wallet Standard disconnect threw:\", error);\n }\n }\n },\n\n getAccount() {\n const address = pickFirstAddress(wallet.accounts);\n if (!address) {\n return Promise.resolve(null);\n }\n return Promise.resolve(buildSolanaAccount(address, currentChain()));\n },\n\n getAccounts() {\n const chain = currentChain();\n return Promise.resolve(wallet.accounts.map((a) => buildSolanaAccount(a.address, chain)));\n },\n\n getBalance() {\n // Wallet Standard exposes no balance feature. Consumers wrap\n // their own RPC client; this default keeps the type signature\n // honoured without lying about a value we don't have.\n return Promise.resolve({\n decimals: SOLANA_DECIMALS,\n formatted: \"0\",\n symbol: \"SOL\",\n value: 0n,\n });\n },\n\n getSigner() {\n // Consumers cast to their preferred wrapper (e.g. an Anchor\n // provider built around the wallet's signTransaction feature).\n return Promise.resolve(wallet);\n },\n\n getTransactionReceipt() {\n // Same reason as `getBalance` — no RPC.\n return Promise.resolve({ status: \"Pending\" as const });\n },\n\n icon: sanitizeIcon(wallet.icon),\n id: slugify(wallet.name),\n name: wallet.name,\n\n async requestAccounts() {\n // Wallet Standard has no equivalent of EIP-2255's\n // `wallet_requestPermissions`. The closest we can do is re-run\n // `standard:connect`, which prompts the user on wallets that\n // surface their picker each time and silently returns the\n // existing list on wallets that remember authorisations.\n // butr's runtime calls `getAccounts()` afterwards to refresh\n // the pool entry, so newly-exposed addresses appear either way.\n await connect.connect();\n },\n\n async sendTx(tx, account) {\n if (!signAndSendTx) {\n throw new Error(`Wallet ${wallet.name} does not advertise solana:signAndSendTransaction`);\n }\n const wsAccount = account\n ? pickAccountByAddress(wallet.accounts, account.walletAddress)\n : (wallet.accounts[0] ?? null);\n if (!wsAccount) {\n throw new Error(\"No connected account\");\n }\n if (!(tx instanceof Uint8Array)) {\n throw new TypeError(\"SVM sendTx expects a serialized transaction (Uint8Array)\");\n }\n const [output] = await signAndSendTx.signAndSendTransaction({\n account: wsAccount,\n chain: currentChainId,\n transaction: tx,\n });\n if (!output) {\n throw new Error(\"signAndSendTransaction returned no outputs\");\n }\n return bytesToBase64(output.signature);\n },\n\n sendTxToChain(tx, _targetChainId, account, cb) {\n // Solana Wallet Standard's signAndSendTransaction takes the\n // target chain directly. `targetChainId` is the decimal-string\n // form butr uses, but the wallet expects a CAIP-2 chain string.\n // For now we honour the connector's primary `solanaChainId` and\n // let consumers route per-chain at a higher level if they need\n // multi-cluster support.\n cb?.();\n return this.sendTx(tx, account);\n },\n\n async signMessage(msg, account) {\n if (!signMessage) {\n throw new Error(`Wallet ${wallet.name} does not advertise solana:signMessage`);\n }\n const wsAccount = account\n ? pickAccountByAddress(wallet.accounts, account.walletAddress)\n : (wallet.accounts[0] ?? null);\n if (!wsAccount) {\n throw new Error(\"No connected account\");\n }\n const [output] = await signMessage.signMessage({ account: wsAccount, message: msg });\n if (!output) {\n throw new Error(\"signMessage returned no outputs\");\n }\n return { signature: output.signature, signedMessage: output.signedMessage };\n },\n\n ...(signTx\n ? {\n async signTransaction(tx, account) {\n // Sign-only path for wallets without\n // solana:signAndSendTransaction. butr ships no RPC, so the\n // caller broadcasts the returned bytes with their own\n // client. Gated by capabilities.signTransaction.\n const wsAccount = account\n ? pickAccountByAddress(wallet.accounts, account.walletAddress)\n : (wallet.accounts[0] ?? null);\n if (!wsAccount) {\n throw new Error(\"No connected account\");\n }\n if (!(tx instanceof Uint8Array)) {\n throw new TypeError(\n \"SVM signTransaction expects a serialized transaction (Uint8Array)\",\n );\n }\n const [output] = await signTx.signTransaction({\n account: wsAccount,\n chain: currentChainId,\n transaction: tx,\n });\n if (!output) {\n throw new Error(\"signTransaction returned no outputs\");\n }\n return output.signedTransaction;\n },\n }\n : {}),\n\n ...(signIn\n ? {\n async signIn(input) {\n // Sign In With Solana. Returns the authenticated account\n // plus the signed statement for server-side verification.\n const [output] = await signIn.signIn(input);\n if (!output) {\n throw new Error(\"signIn returned no outputs\");\n }\n return {\n account: buildSolanaAccount(output.account.address, currentChain()),\n signature: output.signature,\n signedMessage: output.signedMessage,\n };\n },\n }\n : {}),\n\n subscribe(listener) {\n listeners.add(listener);\n let unsubWallet: (() => void) | null = null;\n if (events) {\n const unsub = events.on(\"change\", (changes) => {\n // Chain change: the wallet switched cluster. Re-point\n // currentChainId so subsequent signAndSendTransaction routes\n // through it, mirroring `switchChain`'s local-state model.\n if (changes.chains) {\n const next =\n changes.chains.find((c) => c === \"solana:mainnet\" || c === \"solana:mainnet-beta\") ??\n changes.chains.find((c) => c.startsWith(SOLANA_PREFIX));\n if (next) {\n currentChainId = next;\n }\n }\n\n if (changes.accounts) {\n if (changes.accounts.length === 0) {\n listener({ type: \"disconnected\" });\n return;\n }\n // Forward the FULL accounts list — Wallet Standard's\n // change.accounts reflects the wallet's current exposure\n // set. Mirroring it into the pool entry keeps the array in\n // sync with what the wallet actually allows us to sign with,\n // so single-account-exposure wallets (Phantom Solana,\n // MetaMask Snap) don't accumulate stale addresses.\n const chain = currentChain();\n const built = changes.accounts.map((a) => buildSolanaAccount(a.address, chain));\n const first = built[0];\n if (!first) {\n return;\n }\n listener({ account: first, accounts: built, type: \"accountChanged\" });\n return;\n }\n\n // Chains changed without an accounts change — still push the\n // new chain into the pool entry via the same path switchChain\n // uses, so consumers see the cluster swap.\n if (changes.chains) {\n notifyAccountChanged();\n }\n });\n unsubWallet = () => unsub();\n }\n return () => {\n listeners.delete(listener);\n unsubWallet?.();\n };\n },\n\n switchChain(chain) {\n if (chain.namespace !== \"solana\") {\n throw new Error(\n `SVM adapter received non-Solana chain \"${chain.id}\". Pass a chain with namespace \"solana\".`,\n );\n }\n // The wallet must advertise this cluster — otherwise\n // signAndSendTransaction will reject the chain string later.\n if (!wallet.chains.includes(chain.id)) {\n throw new Error(\n `Wallet ${wallet.name} does not advertise chain \"${chain.id}\". Available: ${wallet.chains.join(\", \")}`,\n );\n }\n currentChainId = chain.id;\n // Synthesise an `accountChanged` so butr's reducer updates the\n // pool entry's chain — the wallet itself has no event to fire here.\n notifyAccountChanged();\n return Promise.resolve();\n },\n };\n};\n\nexport { buildSvmAdapter, slugify };\n","import type { WalletAdapter } from \"@usebutr/core\";\nimport { discoverWalletStandard } from \"@usebutr/wallet-standard-shared\";\n\nimport { buildSvmAdapter } from \"./wallet-standard-adapter\";\n\n/**\n * Subscribe to Solana Wallet Standard announcements.\n * Spec: https://github.com/wallet-standard/wallet-standard\n *\n * Runtime requires the `@wallet-standard/app` package, which is an\n * **optional peer dependency** of butr. EVM-only consumers don't need\n * to install it — discovery will silently skip the SVM side if the\n * module isn't resolvable.\n *\n * Install for SVM auto-discovery:\n *\n * npm install @wallet-standard/app\n *\n * The function returns a synchronous unsubscribe that's safe to call\n * before the dynamic import has resolved.\n *\n * Implementation: the discovery loop (dynamic import, dedupe, register\n * / unregister bridge) lives in `@usebutr/wallet-standard-shared`. This\n * file's only job is to hand the kit a per-wallet builder.\n */\nconst discoverSvmAdapters = (onAdapter: (adapter: WalletAdapter) => void): (() => void) =>\n discoverWalletStandard(onAdapter, (wallet, registerDisconnector) =>\n buildSvmAdapter(wallet, registerDisconnector),\n );\n\nexport { discoverSvmAdapters };\n","import type { ChainBase } from \"@usebutr/core\";\n\n// Solana chain identifiers follow the Wallet Standard convention\n// (`solana:mainnet` / `solana:devnet` / `solana:testnet`) rather than\n// the strict CAIP-2 genesis-hash form (`solana:5eykt…`). Phantom,\n// Solflare, Backpack and the rest of the Wallet Standard ecosystem\n// advertise these shortnames in `wallet.chains`, and the SVM adapter's\n// `switchChain` rejects anything not in that set. The genesis-hash form\n// remains valid CAIP-2 but isn't what real wallets exchange.\nconst SVM_CHAINS = {\n devnet: { id: \"solana:devnet\", name: \"Solana Devnet\", namespace: \"solana\", reference: \"devnet\" },\n mainnet: {\n id: \"solana:mainnet\",\n name: \"Solana Mainnet\",\n namespace: \"solana\",\n reference: \"mainnet\",\n },\n testnet: {\n id: \"solana:testnet\",\n name: \"Solana Testnet\",\n namespace: \"solana\",\n reference: \"testnet\",\n },\n} as const satisfies Record<string, ChainBase>;\n\nconst SVM_CHAINS_LIST: ReadonlyArray<ChainBase> = Object.values(SVM_CHAINS);\n\nexport { SVM_CHAINS, SVM_CHAINS_LIST };\n","import type { PlatformDiscoverer } from \"@usebutr/core\";\n\nimport { discoverSvmAdapters } from \"./wallet-standard\";\n\n/**\n * SVM's `PlatformDiscoverer`: Solana Wallet Standard announcements. No\n * legacy fallback — Solana wallets standardised on Wallet Standard\n * before butr existed, so there's no `window.solana` injected path\n * worth shimming.\n */\nconst svmDiscoverer: PlatformDiscoverer = {\n platform: \"svm\",\n subscribe: discoverSvmAdapters,\n};\n\nexport { svmDiscoverer };\n"],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@usebutr/svm",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.1",
|
|
4
4
|
"description": "Wallet Standard adapter for butr (Solana / SVM).",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"author": "Pedro Filho <pedro@filho.me>",
|
|
@@ -25,8 +25,8 @@
|
|
|
25
25
|
"access": "public"
|
|
26
26
|
},
|
|
27
27
|
"dependencies": {
|
|
28
|
-
"@usebutr/core": "0.2.
|
|
29
|
-
"@usebutr/wallet-standard-shared": "0.2.
|
|
28
|
+
"@usebutr/core": "0.2.1",
|
|
29
|
+
"@usebutr/wallet-standard-shared": "0.2.1"
|
|
30
30
|
},
|
|
31
31
|
"devDependencies": {
|
|
32
32
|
"@wallet-standard/app": "^1.1.0",
|