@rango-dev/provider-ledger-wallet 0.1.1-next.0

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/CHANGELOG.md ADDED
File without changes
@@ -0,0 +1,4 @@
1
+ import type { ProviderMetadata } from '@hub3js/core';
2
+ export declare const WALLET_ID = "ledger-wallet";
3
+ export declare const EVM_SUPPORTED_CHAINS: string[];
4
+ export declare const metadata: ProviderMetadata;
@@ -0,0 +1,3 @@
1
+ import type { ProviderAPI } from '@hub3js/evm';
2
+ export declare function setProvider(p: ProviderAPI): void;
3
+ export declare function getProvider(): ProviderAPI;
package/dist/mod.d.ts ADDED
@@ -0,0 +1,3 @@
1
+ declare const versions: () => readonly [readonly ["1.0.0", import("@hub3js/core").Provider<Record<"evm", import("@hub3js/evm").EvmActions>>]];
2
+ export { versions };
3
+ export { WALLET_ID } from './constants.js';
package/dist/mod.js ADDED
@@ -0,0 +1,2 @@
1
+ var h=Object.defineProperty;var t=(e,r)=>h(e,"name",{value:r,configurable:!0});var A=(e,r)=>()=>(e&&(r=e(e=0)),r);var D=(e,r)=>{for(var i in r)h(e,i,{get:r[i],enumerable:!0})};function E(e){u=e}function n(){if(!u)throw new Error("Ledger Wallet provider is not set. Make sure the Ledger Button has announced itself over EIP-6963.");return u}var u,p=A(()=>{"use strict";t(E,"setProvider");t(n,"getProvider")});var w={};D(w,{CustomEvmSigner:()=>v});import{cleanEvmError as N,DefaultEvmSigner as M}from"@rango-dev/signer-evm";var x,s,H,v,y=A(()=>{"use strict";p();x=16,s=t(e=>"0x"+BigInt(e).toString(x),"toHexQuantity"),H=t(e=>{let r={data:e.data||"0x",value:e.value?s(e.value):"0x0"};return e.from&&(r.from=e.from),e.to&&(r.to=e.to),e.nonce&&(r.nonce=s(e.nonce)),e.gasLimit&&(r.gas=s(e.gasLimit)),e.maxFeePerGas&&e.maxPriorityFeePerGas?(r.maxFeePerGas=s(e.maxFeePerGas),r.maxPriorityFeePerGas=s(e.maxPriorityFeePerGas)):e.gasPrice&&(r.gasPrice=s(e.gasPrice)),r},"buildLedgerTx"),v=class{static{t(this,"CustomEvmSigner")}defaultEvmSigner;constructor(){this.defaultEvmSigner=new M(n())}async signMessage(r){return await this.defaultEvmSigner.signMessage(r)}async signTypedData(r){return await this.defaultEvmSigner.signTypedData(r)}async signAndSendTx(r,i,c){try{return{hash:await n().request({method:"eth_sendTransaction",params:[H(r)]})}}catch(o){throw N(o)}}async wait(r){return{hash:r}}}});import{defineVersions as ae}from"@hub3js/core/utils";import{ProviderBuilder as ne}from"@hub3js/core";import{CAIP_ARBITRUM_CHAIN_ID as G,CAIP_AVAX_CHAIN_ID as k,CAIP_BASE_CHAIN_ID as q,CAIP_BSC_CHAIN_ID as O,CAIP_ETHEREUM_CHAIN_ID as V,CAIP_LINEA_CHAIN_ID as W,CAIP_OPTIMISM_CHAIN_ID as R,CAIP_POLYGON_CHAIN_ID as j,CAIP_SONIC_CHAIN_ID as z,CAIP_ZKSYNC_CHAIN_ID as K,isEvmNamespace as U}from"@hub3js/evm";import{getChainIdFromCaip2ChainId as X}from"@hub3js/std/utils";import{DefaultSignerFactory as B,TransactionType as F}from"rango-types";async function f(){let e=new B,{CustomEvmSigner:r}=await Promise.resolve().then(()=>(y(),w));return e.registerSigner(F.EVM,new r),e}t(f,"getSigners");var d="ledger-wallet",Y=[V,R,O,j,z,q,G,k,W,K],_={name:"Ledger Wallet",icon:"https://raw.githubusercontent.com/rango-exchange/assets/main/wallets/ledger/icon.svg",extensions:{homepage:"https://www.ledger.com/"},properties:[{name:"namespaces",value:{selection:"single",data:[{label:"EVM",value:"EVM",id:"ETH",isChainSupported:e=>U(e)&&Y.includes(X(e))}]}},{name:"signers",value:{getSigners:async()=>f()}},{name:"details",value:{showOnMobile:!1}}]};p();import{NamespaceBuilder as Q}from"@hub3js/core";import{actions as I,builders as m,utils as P}from"@hub3js/evm";import*as C from"@hub3js/std/builders";import{standardizeAndThrowError as Z}from"@hub3js/std/operators";p();var[J,S]=m.changeAccountSubscriber(n).format(async(e,r)=>{let i=await e.request({method:"eth_chainId"});return P.formatAccountsToCAIP([r[0]],i)}).build(),$=m.connect().action(async(e,r)=>{let i=n(),c=await i.request({method:"eth_requestAccounts"});r&&await P.switchOrAddNetwork(i,r);let o=await i.request({method:"eth_chainId"});return{accounts:P.formatAccountsToCAIP([c[0]],o),network:o}}).before(J).or(S).or(Z).build(),ee=C.disconnect().before(async()=>{try{await n().disconnect()}catch(e){console.error("[ledger-wallet] provider.disconnect failed",e)}}).after(S).build(),re=m.canEagerConnect().action(()=>I.canEagerConnect(n)).build(),te=m.canSwitchNetwork().action(I.canSwitchNetwork()).build(),ie=m.getChainId().action(I.getChainId(n)).build(),L=new Q("EVM",d).action($).action(ee).action(re).action(te).action(ie).build();var oe="Ledger Wallet",T=t(()=>new ne(d).init(function(e,r){let[,i]=e.state(),c=t(a=>{let{provider:l,info:b}=a.detail;b.name===oe&&(E(l),i("installed",!0))},"handleAnnounceProvider");if(!r?.dAppIdentifier||!r?.apiKey)throw new Error("Ledger Wallet dApp identifier and API key are required");let o=t(async()=>{await import("@ledgerhq/ledger-wallet-provider/styles.css");let{initializeLedgerProvider:a}=await import("@ledgerhq/ledger-wallet-provider");window.addEventListener("eip6963:announceProvider",c);let l=a({dAppIdentifier:r.dAppIdentifier,apiKey:r.apiKey,loggerLevel:r.loggerLevel||"info",hideButton:r.hideButton});return window.dispatchEvent(new Event("eip6963:requestProvider")),l},"initializeProvider"),g;return o().then(a=>{g=a}).catch(a=>{console.error("[ledger-wallet] failed to initialize provider",a)}),()=>{g?.(),window.removeEventListener("eip6963:announceProvider",c)}}).config("metadata",_).add("evm",L).build(),"buildProvider");var He=t(()=>ae().version("1.0.0",T()).build(),"versions");export{d as WALLET_ID,He as versions};
2
+ //# sourceMappingURL=mod.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../src/ledgerProvider.ts", "../src/signers/evm.ts", "../src/mod.ts", "../src/provider.ts", "../src/constants.ts", "../src/signer.ts", "../src/namespaces/evm.ts"],
4
+ "sourcesContent": ["import type { ProviderAPI } from '@hub3js/evm';\n\n/*\n * The Ledger Wallet Provider (Ledger Button) hands us an EIP-1193 provider\n * through the EIP-6963 announce event. We stash it here so the EVM namespace\n * actions and the signer can reach it. It's typed as hub3's `ProviderAPI`\n * (itself an `EIP1193Provider`) so it plugs straight into `actions.*`.\n */\nlet provider: ProviderAPI | undefined;\n\nexport function setProvider(p: ProviderAPI) {\n provider = p;\n}\n\nexport function getProvider(): ProviderAPI {\n if (!provider) {\n throw new Error(\n 'Ledger Wallet provider is not set. Make sure the Ledger Button has announced itself over EIP-6963.'\n );\n }\n return provider;\n}\n", "import type { TypedData } from '@rango-dev/signer-evm';\nimport type { GenericSigner } from 'rango-types';\nimport type { EvmTransaction } from 'rango-types/mainApi';\n\nimport { cleanEvmError, DefaultEvmSigner } from '@rango-dev/signer-evm';\n\nimport { getProvider } from '../ledgerProvider.js';\n\nconst HEXADECIMAL_BASE = 16;\n\n/*\n * Ledger's eth_sendTransaction params (see EthSendTransactionParams):\n * - use `gas`, not ethers' `gasLimit`. TransactionHelper only reads\n * `transaction.gas` \u2192 ethers gasLimit; a `gasLimit` key is ignored.\n * - quantities should be hex. Ledger parses nonce with parseInt(nonce, 16),\n * so a decimal nonce would be wrong. Hex also keeps fees in JSON-RPC form.\n *\n * If gas + maxFeePerGas + maxPriorityFeePerGas are not all set, Ledger\n * re-estimates and overwrites those three fields (EIP-1559). So for swaps we\n * must pass the full triad when Rango provides EIP-1559 fees; otherwise Rango's\n * gas limit is dropped.\n * https://developers.ledger.com/docs/ledger-wallet-provider/api-reference\n */\ntype LedgerTransactionParams = {\n data: string;\n from?: string;\n to?: string;\n value?: string;\n nonce?: string;\n gas?: string;\n gasPrice?: string;\n maxFeePerGas?: string;\n maxPriorityFeePerGas?: string;\n};\n\n/** Hex-encode a Rango quantity (`0x\u2026` or decimal string). BigInt accepts both. */\nconst toHexQuantity = (value: string): string =>\n '0x' + BigInt(value).toString(HEXADECIMAL_BASE);\n\n/*\n * Map Rango's EvmTransaction to Ledger's JSON-RPC shape: gasLimit \u2192 gas,\n * quantities hex-encoded, EIP-1559 preferred over legacy gasPrice.\n */\nconst buildLedgerTx = (tx: EvmTransaction): LedgerTransactionParams => {\n /*\n * Always send data and value:\n * - data: `0x` instead of undefined (same as DefaultEvmSigner.buildTx).\n * - value: Ledger's internal Transaction type requires value; omit it on\n * zero-value txs (approvals) and fee estimation / serialization can\n * break. Default to 0x0.\n */\n const params: LedgerTransactionParams = {\n data: tx.data || '0x',\n value: tx.value ? toHexQuantity(tx.value) : '0x0',\n };\n if (tx.from) {\n params.from = tx.from;\n }\n if (tx.to) {\n params.to = tx.to;\n }\n if (tx.nonce) {\n params.nonce = toHexQuantity(tx.nonce);\n }\n if (tx.gasLimit) {\n params.gas = toHexQuantity(tx.gasLimit);\n }\n if (tx.maxFeePerGas && tx.maxPriorityFeePerGas) {\n params.maxFeePerGas = toHexQuantity(tx.maxFeePerGas);\n params.maxPriorityFeePerGas = toHexQuantity(tx.maxPriorityFeePerGas);\n } else if (tx.gasPrice) {\n /*\n * Legacy path: Ledger still requires maxFee* to skip re-estimation, so it\n * will overwrite gas/fees with its own EIP-1559 estimate. We only forward\n * gasPrice for wallets that honor it; do not expect Rango's gasLimit to\n * stick on this path.\n */\n params.gasPrice = toHexQuantity(tx.gasPrice);\n }\n return params;\n};\n\n/*\n * Implement GenericSigner so signAndSendTx can return only `{ hash }` \u2014\n * Ledger's eth_sendTransaction never yields an ethers TransactionResponse.\n * Delegate personal_sign / eth_signTypedData_v4 to DefaultEvmSigner (supported\n * by Ledger). Do not use its signAndSendTx: ethers then polls\n * eth_getTransactionByHash, which Ledger does not support.\n */\nexport class CustomEvmSigner implements GenericSigner<EvmTransaction> {\n private defaultEvmSigner: DefaultEvmSigner;\n\n constructor() {\n /*\n * Provider comes from the EIP-6963 announce stashed in ledgerProvider\n * (getSigners runs after connect, so it should already be set).\n */\n this.defaultEvmSigner = new DefaultEvmSigner(getProvider());\n }\n\n async signMessage(msg: string): Promise<string> {\n return await this.defaultEvmSigner.signMessage(msg);\n }\n\n async signTypedData(typedData: TypedData): Promise<string> {\n return await this.defaultEvmSigner.signTypedData(typedData);\n }\n\n async signAndSendTx(\n tx: EvmTransaction,\n /*\n * Unused on purpose:\n * - Ledger eth_sendTransaction does not validate tx.from against the\n * selected account (unlike eth_signTypedData*), so an address check\n * here cannot stop a wrong-account sign.\n * - Network is enforced upstream by\n * checkEnvironmentBeforeExecuteTransaction.\n */\n _address: string,\n _chainId: string | null\n ): Promise<{ hash: string }> {\n try {\n const provider = getProvider();\n\n const hash = await provider.request({\n method: 'eth_sendTransaction',\n params: [buildLedgerTx(tx)],\n });\n\n return { hash };\n } catch (error) {\n throw cleanEvmError(error);\n }\n }\n\n /*\n * Tx is already broadcast; Ledger cannot serve getTransaction/receipts.\n * Return the hash so checkStatus can continue via the API watcher.\n */\n async wait(txHash: string): Promise<{ hash: string }> {\n return { hash: txHash };\n }\n}\n", "import { defineVersions } from '@hub3js/core/utils';\n\nimport { buildProvider } from './provider.js';\n\nconst versions = () =>\n defineVersions().version('1.0.0', buildProvider()).build();\n\nexport { versions };\nexport { WALLET_ID } from './constants.js';\n", "import type { Environments } from './types.js';\nimport type { ProviderAPI } from '@hub3js/evm';\nimport type { EIP6963ProviderDetail } from '@ledgerhq/ledger-wallet-provider';\n\nimport { ProviderBuilder } from '@hub3js/core';\n\nimport { metadata, WALLET_ID } from './constants.js';\nimport { setProvider } from './ledgerProvider.js';\nimport { evm } from './namespaces/evm.js';\n\nconst LEDGER_PROVIDER_NAME = 'Ledger Wallet';\n\nconst buildProvider = () =>\n new ProviderBuilder(WALLET_ID)\n .init(function (context, environments: Environments) {\n const [, setState] = context.state();\n\n const handleAnnounceProvider = (\n e: CustomEvent<EIP6963ProviderDetail>\n ) => {\n const { provider, info } = e.detail;\n\n if (info.name === LEDGER_PROVIDER_NAME) {\n /*\n * hub3 actions/signer consume the EIP-1193 provider as `ProviderAPI`.\n * Ledger's EIP1193Provider and hub3's don't structurally overlap, so\n * cast through `unknown`.\n */\n setProvider(provider as unknown as ProviderAPI);\n setState('installed', true);\n }\n };\n\n if (!environments?.dAppIdentifier || !environments?.apiKey) {\n throw new Error(\n 'Ledger Wallet dApp identifier and API key are required'\n );\n }\n\n const initializeProvider = async () => {\n /*\n * Load Ledger's runtime and its stylesheet lazily (both resolved from\n * the external `@ledgerhq/ledger-wallet-provider` dependency by the host\n * bundler) so we only pull them in when the provider initializes.\n */\n await import('@ledgerhq/ledger-wallet-provider/styles.css');\n const { initializeLedgerProvider } = await import(\n '@ledgerhq/ledger-wallet-provider'\n );\n\n /*\n * Attach the listener BEFORE initializing so we don't race the\n * provider's immediate announce that fires during initialization.\n */\n window.addEventListener(\n 'eip6963:announceProvider',\n handleAnnounceProvider as EventListener\n );\n\n const cleanup = initializeLedgerProvider({\n dAppIdentifier: environments.dAppIdentifier,\n apiKey: environments.apiKey,\n loggerLevel: environments.loggerLevel || 'info',\n hideButton: environments.hideButton,\n });\n\n /*\n * Ask every EIP-6963 provider to (re-)announce itself. Without this\n * request the listener only ever sees the one-shot announce above.\n */\n window.dispatchEvent(new Event('eip6963:requestProvider'));\n\n return cleanup;\n };\n\n let cleanup: (() => void) | undefined;\n\n initializeProvider()\n .then((cleanupFn) => {\n cleanup = cleanupFn;\n })\n .catch((error) => {\n console.error('[ledger-wallet] failed to initialize provider', error);\n });\n\n return () => {\n cleanup?.();\n window.removeEventListener(\n 'eip6963:announceProvider',\n handleAnnounceProvider as EventListener\n );\n };\n })\n .config('metadata', metadata)\n .add('evm', evm)\n .build();\n\nexport { buildProvider };\n", "import type { ProviderMetadata } from '@hub3js/core';\n\nimport {\n CAIP_ARBITRUM_CHAIN_ID,\n CAIP_AVAX_CHAIN_ID,\n CAIP_BASE_CHAIN_ID,\n CAIP_BSC_CHAIN_ID,\n CAIP_ETHEREUM_CHAIN_ID,\n CAIP_LINEA_CHAIN_ID,\n CAIP_OPTIMISM_CHAIN_ID,\n CAIP_POLYGON_CHAIN_ID,\n CAIP_SONIC_CHAIN_ID,\n CAIP_ZKSYNC_CHAIN_ID,\n isEvmNamespace,\n} from '@hub3js/evm';\nimport { getChainIdFromCaip2ChainId } from '@hub3js/std/utils';\n\nimport getSigners from './signer.js';\n\nexport const WALLET_ID = 'ledger-wallet';\n\n/*\n * EVM chains supported by the Ledger Wallet Provider (Ledger Button).\n * Mirrors the provider's internal chain-id allow-list:\n * 1 (ETH), 10 (Optimism), 56 (BSC), 137 (Polygon), 146 (Sonic),\n * 324 (zkSync Era), 8453 (Base), 42161 (Arbitrum), 43114 (Avalanche),\n * 59144 (Linea).\n */\nexport const EVM_SUPPORTED_CHAINS = [\n CAIP_ETHEREUM_CHAIN_ID,\n CAIP_OPTIMISM_CHAIN_ID,\n CAIP_BSC_CHAIN_ID,\n CAIP_POLYGON_CHAIN_ID,\n CAIP_SONIC_CHAIN_ID,\n CAIP_BASE_CHAIN_ID,\n CAIP_ARBITRUM_CHAIN_ID,\n CAIP_AVAX_CHAIN_ID,\n CAIP_LINEA_CHAIN_ID,\n CAIP_ZKSYNC_CHAIN_ID,\n];\n\nexport const metadata: ProviderMetadata = {\n name: 'Ledger Wallet',\n icon: 'https://raw.githubusercontent.com/rango-exchange/assets/main/wallets/ledger/icon.svg',\n extensions: {\n homepage: 'https://www.ledger.com/',\n },\n properties: [\n {\n name: 'namespaces',\n value: {\n selection: 'single',\n data: [\n {\n label: 'EVM',\n value: 'EVM',\n id: 'ETH',\n isChainSupported: (chainId: string) =>\n isEvmNamespace(chainId) &&\n EVM_SUPPORTED_CHAINS.includes(\n getChainIdFromCaip2ChainId(chainId)\n ),\n },\n ],\n },\n },\n {\n name: 'signers',\n value: { getSigners: async () => getSigners() },\n },\n {\n name: 'details',\n value: {\n showOnMobile: false,\n },\n },\n ],\n};\n", "import type { SignerFactory } from 'rango-types';\n\nimport { DefaultSignerFactory, TransactionType as TxType } from 'rango-types';\n\nexport default async function getSigners(): Promise<SignerFactory> {\n const signers = new DefaultSignerFactory();\n const { CustomEvmSigner } = await import('./signers/evm.js');\n signers.registerSigner(TxType.EVM, new CustomEvmSigner());\n\n return signers;\n}\n", "import type { Context } from '@hub3js/core';\nimport type { Chain, ChainId, EvmActions } from '@hub3js/evm';\n\nimport { NamespaceBuilder } from '@hub3js/core';\nimport { actions, builders, utils } from '@hub3js/evm';\nimport * as commonBuilders from '@hub3js/std/builders';\nimport { standardizeAndThrowError } from '@hub3js/std/operators';\n\nimport { WALLET_ID } from '../constants.js';\nimport { getProvider } from '../ledgerProvider.js';\n\nconst [changeAccountSubscriber, changeAccountCleanup] = builders\n .changeAccountSubscriber(getProvider)\n /*\n * The Ledger Button returns the connected accounts with the active one first.\n * Since we only need the active account, we take the first element.\n */\n .format(async (instance, accounts) => {\n const chainId = await instance.request({ method: 'eth_chainId' });\n return utils.formatAccountsToCAIP([accounts[0]], chainId);\n })\n .build();\n\n/*\n * The Ledger provider rejects every method except `eth_requestAccounts` with\n * \"Unauthorized\" until it is connected, so we must request accounts FIRST to\n * establish the session, and only then switch chain / read the chain id.\n */\nconst connect = builders\n .connect()\n .action(async (_context: Context<EvmActions>, chain?: Chain | ChainId) => {\n const provider = getProvider();\n\n const accounts = await provider.request({\n method: 'eth_requestAccounts',\n });\n\n if (chain) {\n await utils.switchOrAddNetwork(provider, chain);\n }\n\n const chainId = await provider.request({\n method: 'eth_chainId',\n });\n\n /*\n * The Ledger provider returns the connected accounts with the active one\n * first, so we take the first element as the active account.\n */\n return {\n accounts: utils.formatAccountsToCAIP([accounts[0]], chainId),\n network: chainId,\n };\n })\n .before(changeAccountSubscriber)\n .or(changeAccountCleanup)\n .or(standardizeAndThrowError)\n .build();\n\nconst disconnect = commonBuilders\n .disconnect<EvmActions>()\n /*\n * Tell the Ledger provider to clear its cached account/chain (see\n * `LedgerEIP1193Provider.disconnect`) so a later reconnect starts clean.\n * It must never make our own disconnect flow fail, hence the guard.\n */\n .before(async () => {\n try {\n /*\n * hub3 types `disconnect` as `() => void`, but the Ledger provider's\n * implementation is async, so cast to await the real promise (and let\n * the catch handle a rejection).\n */\n await (getProvider().disconnect() as unknown as Promise<void>);\n } catch (error) {\n console.error('[ledger-wallet] provider.disconnect failed', error);\n }\n })\n .after(changeAccountCleanup)\n .build();\n\nconst canEagerConnect = builders\n .canEagerConnect()\n .action(() => {\n return actions.canEagerConnect(getProvider);\n })\n .build();\n\nconst canSwitchNetwork = builders\n .canSwitchNetwork()\n .action(actions.canSwitchNetwork())\n .build();\n\nconst getChainId = builders\n .getChainId()\n .action(actions.getChainId(getProvider))\n .build();\n\nconst evm = new NamespaceBuilder<EvmActions>('EVM', WALLET_ID)\n .action(connect)\n .action(disconnect)\n .action(canEagerConnect)\n .action(canSwitchNetwork)\n .action(getChainId)\n .build();\n\nexport { evm };\n"],
5
+ "mappings": "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",
6
+ "names": ["setProvider", "p", "provider", "getProvider", "init_ledgerProvider", "__esmMin", "__name", "evm_exports", "__export", "CustomEvmSigner", "cleanEvmError", "DefaultEvmSigner", "HEXADECIMAL_BASE", "toHexQuantity", "buildLedgerTx", "init_evm", "__esmMin", "init_ledgerProvider", "__name", "value", "tx", "params", "getProvider", "msg", "typedData", "_address", "_chainId", "error", "txHash", "defineVersions", "ProviderBuilder", "CAIP_ARBITRUM_CHAIN_ID", "CAIP_AVAX_CHAIN_ID", "CAIP_BASE_CHAIN_ID", "CAIP_BSC_CHAIN_ID", "CAIP_ETHEREUM_CHAIN_ID", "CAIP_LINEA_CHAIN_ID", "CAIP_OPTIMISM_CHAIN_ID", "CAIP_POLYGON_CHAIN_ID", "CAIP_SONIC_CHAIN_ID", "CAIP_ZKSYNC_CHAIN_ID", "isEvmNamespace", "getChainIdFromCaip2ChainId", "DefaultSignerFactory", "TxType", "getSigners", "signers", "DefaultSignerFactory", "CustomEvmSigner", "TxType", "__name", "WALLET_ID", "EVM_SUPPORTED_CHAINS", "CAIP_ETHEREUM_CHAIN_ID", "CAIP_OPTIMISM_CHAIN_ID", "CAIP_BSC_CHAIN_ID", "CAIP_POLYGON_CHAIN_ID", "CAIP_SONIC_CHAIN_ID", "CAIP_BASE_CHAIN_ID", "CAIP_ARBITRUM_CHAIN_ID", "CAIP_AVAX_CHAIN_ID", "CAIP_LINEA_CHAIN_ID", "CAIP_ZKSYNC_CHAIN_ID", "metadata", "chainId", "isEvmNamespace", "getChainIdFromCaip2ChainId", "getSigners", "init_ledgerProvider", "NamespaceBuilder", "actions", "builders", "utils", "commonBuilders", "standardizeAndThrowError", "init_ledgerProvider", "changeAccountSubscriber", "changeAccountCleanup", "builders", "getProvider", "instance", "accounts", "chainId", "utils", "connect", "_context", "chain", "provider", "standardizeAndThrowError", "disconnect", "error", "canEagerConnect", "actions", "canSwitchNetwork", "getChainId", "evm", "NamespaceBuilder", "WALLET_ID", "LEDGER_PROVIDER_NAME", "buildProvider", "__name", "ProviderBuilder", "WALLET_ID", "context", "environments", "setState", "handleAnnounceProvider", "e", "provider", "info", "setProvider", "initializeProvider", "initializeLedgerProvider", "cleanup", "cleanupFn", "error", "metadata", "evm", "versions", "__name", "defineVersions", "buildProvider"]
7
+ }
@@ -0,0 +1,3 @@
1
+ import type { EvmActions } from '@hub3js/evm';
2
+ declare const evm: import("@hub3js/core").ProxiedNamespace<EvmActions>;
3
+ export { evm };
@@ -0,0 +1,2 @@
1
+ declare const buildProvider: () => import("@hub3js/core").Provider<Record<"evm", import("@hub3js/evm").EvmActions>>;
2
+ export { buildProvider };
@@ -0,0 +1,2 @@
1
+ import type { SignerFactory } from 'rango-types';
2
+ export default function getSigners(): Promise<SignerFactory>;
@@ -0,0 +1,15 @@
1
+ import type { TypedData } from '@rango-dev/signer-evm';
2
+ import type { GenericSigner } from 'rango-types';
3
+ import type { EvmTransaction } from 'rango-types/mainApi';
4
+ export declare class CustomEvmSigner implements GenericSigner<EvmTransaction> {
5
+ private defaultEvmSigner;
6
+ constructor();
7
+ signMessage(msg: string): Promise<string>;
8
+ signTypedData(typedData: TypedData): Promise<string>;
9
+ signAndSendTx(tx: EvmTransaction, _address: string, _chainId: string | null): Promise<{
10
+ hash: string;
11
+ }>;
12
+ wait(txHash: string): Promise<{
13
+ hash: string;
14
+ }>;
15
+ }
@@ -0,0 +1,6 @@
1
+ export type Environments = {
2
+ dAppIdentifier: string;
3
+ apiKey: string;
4
+ loggerLevel?: 'fatal' | 'error' | 'warn' | 'info' | 'debug';
5
+ hideButton?: boolean;
6
+ };
package/package.json ADDED
@@ -0,0 +1,34 @@
1
+ {
2
+ "name": "@rango-dev/provider-ledger-wallet",
3
+ "version": "0.1.1-next.0",
4
+ "license": "MIT",
5
+ "type": "module",
6
+ "source": "./src/mod.ts",
7
+ "main": "./dist/mod.js",
8
+ "exports": {
9
+ ".": "./dist/mod.js"
10
+ },
11
+ "typings": "dist/mod.d.ts",
12
+ "files": [
13
+ "dist",
14
+ "src"
15
+ ],
16
+ "scripts": {
17
+ "build": "yarn run rangutopia library build",
18
+ "ts-check": "tsc --declaration --emitDeclarationOnly -p ./tsconfig.json",
19
+ "clean": "rimraf dist",
20
+ "format": "prettier --write '{.,src}/**/*.{ts,tsx}'",
21
+ "lint": "eslint \"**/*.{ts,tsx}\""
22
+ },
23
+ "dependencies": {
24
+ "@hub3js/core": "^0.62.0",
25
+ "@hub3js/evm": "^0.5.0",
26
+ "@hub3js/std": "^0.4.0",
27
+ "@ledgerhq/ledger-wallet-provider": "^1.4.2",
28
+ "@rango-dev/signer-evm": "^0.45.1-next.1",
29
+ "rango-types": "^0.5.0"
30
+ },
31
+ "publishConfig": {
32
+ "access": "public"
33
+ }
34
+ }
package/readme.md ADDED
@@ -0,0 +1,16 @@
1
+ # Ledger Wallet
2
+
3
+ Ledger Wallet integration for hub.
4
+ [Homepage](https://www.ledger.com/) | [Docs](https://developers.ledger.com/docs/ledger-wallet-provider/overview)
5
+
6
+ ## Implementation notes/limitations
7
+
8
+ ### Group
9
+
10
+ #### ⚠️ EVM
11
+
12
+ Provider only supports a subset of EVM chains listed here in [constants.ts](./src/constants.ts).
13
+
14
+ ---
15
+
16
+ More wallet information can be found in [readme.md](../readme.md).
@@ -0,0 +1,78 @@
1
+ import type { ProviderMetadata } from '@hub3js/core';
2
+
3
+ import {
4
+ CAIP_ARBITRUM_CHAIN_ID,
5
+ CAIP_AVAX_CHAIN_ID,
6
+ CAIP_BASE_CHAIN_ID,
7
+ CAIP_BSC_CHAIN_ID,
8
+ CAIP_ETHEREUM_CHAIN_ID,
9
+ CAIP_LINEA_CHAIN_ID,
10
+ CAIP_OPTIMISM_CHAIN_ID,
11
+ CAIP_POLYGON_CHAIN_ID,
12
+ CAIP_SONIC_CHAIN_ID,
13
+ CAIP_ZKSYNC_CHAIN_ID,
14
+ isEvmNamespace,
15
+ } from '@hub3js/evm';
16
+ import { getChainIdFromCaip2ChainId } from '@hub3js/std/utils';
17
+
18
+ import getSigners from './signer.js';
19
+
20
+ export const WALLET_ID = 'ledger-wallet';
21
+
22
+ /*
23
+ * EVM chains supported by the Ledger Wallet Provider (Ledger Button).
24
+ * Mirrors the provider's internal chain-id allow-list:
25
+ * 1 (ETH), 10 (Optimism), 56 (BSC), 137 (Polygon), 146 (Sonic),
26
+ * 324 (zkSync Era), 8453 (Base), 42161 (Arbitrum), 43114 (Avalanche),
27
+ * 59144 (Linea).
28
+ */
29
+ export const EVM_SUPPORTED_CHAINS = [
30
+ CAIP_ETHEREUM_CHAIN_ID,
31
+ CAIP_OPTIMISM_CHAIN_ID,
32
+ CAIP_BSC_CHAIN_ID,
33
+ CAIP_POLYGON_CHAIN_ID,
34
+ CAIP_SONIC_CHAIN_ID,
35
+ CAIP_BASE_CHAIN_ID,
36
+ CAIP_ARBITRUM_CHAIN_ID,
37
+ CAIP_AVAX_CHAIN_ID,
38
+ CAIP_LINEA_CHAIN_ID,
39
+ CAIP_ZKSYNC_CHAIN_ID,
40
+ ];
41
+
42
+ export const metadata: ProviderMetadata = {
43
+ name: 'Ledger Wallet',
44
+ icon: 'https://raw.githubusercontent.com/rango-exchange/assets/main/wallets/ledger/icon.svg',
45
+ extensions: {
46
+ homepage: 'https://www.ledger.com/',
47
+ },
48
+ properties: [
49
+ {
50
+ name: 'namespaces',
51
+ value: {
52
+ selection: 'single',
53
+ data: [
54
+ {
55
+ label: 'EVM',
56
+ value: 'EVM',
57
+ id: 'ETH',
58
+ isChainSupported: (chainId: string) =>
59
+ isEvmNamespace(chainId) &&
60
+ EVM_SUPPORTED_CHAINS.includes(
61
+ getChainIdFromCaip2ChainId(chainId)
62
+ ),
63
+ },
64
+ ],
65
+ },
66
+ },
67
+ {
68
+ name: 'signers',
69
+ value: { getSigners: async () => getSigners() },
70
+ },
71
+ {
72
+ name: 'details',
73
+ value: {
74
+ showOnMobile: false,
75
+ },
76
+ },
77
+ ],
78
+ };
package/src/css.d.ts ADDED
@@ -0,0 +1,2 @@
1
+ // Allow side-effect CSS imports (e.g. `@ledgerhq/ledger-wallet-provider/styles.css`).
2
+ declare module '*.css';
@@ -0,0 +1,22 @@
1
+ import type { ProviderAPI } from '@hub3js/evm';
2
+
3
+ /*
4
+ * The Ledger Wallet Provider (Ledger Button) hands us an EIP-1193 provider
5
+ * through the EIP-6963 announce event. We stash it here so the EVM namespace
6
+ * actions and the signer can reach it. It's typed as hub3's `ProviderAPI`
7
+ * (itself an `EIP1193Provider`) so it plugs straight into `actions.*`.
8
+ */
9
+ let provider: ProviderAPI | undefined;
10
+
11
+ export function setProvider(p: ProviderAPI) {
12
+ provider = p;
13
+ }
14
+
15
+ export function getProvider(): ProviderAPI {
16
+ if (!provider) {
17
+ throw new Error(
18
+ 'Ledger Wallet provider is not set. Make sure the Ledger Button has announced itself over EIP-6963.'
19
+ );
20
+ }
21
+ return provider;
22
+ }
package/src/mod.ts ADDED
@@ -0,0 +1,9 @@
1
+ import { defineVersions } from '@hub3js/core/utils';
2
+
3
+ import { buildProvider } from './provider.js';
4
+
5
+ const versions = () =>
6
+ defineVersions().version('1.0.0', buildProvider()).build();
7
+
8
+ export { versions };
9
+ export { WALLET_ID } from './constants.js';
@@ -0,0 +1,107 @@
1
+ import type { Context } from '@hub3js/core';
2
+ import type { Chain, ChainId, EvmActions } from '@hub3js/evm';
3
+
4
+ import { NamespaceBuilder } from '@hub3js/core';
5
+ import { actions, builders, utils } from '@hub3js/evm';
6
+ import * as commonBuilders from '@hub3js/std/builders';
7
+ import { standardizeAndThrowError } from '@hub3js/std/operators';
8
+
9
+ import { WALLET_ID } from '../constants.js';
10
+ import { getProvider } from '../ledgerProvider.js';
11
+
12
+ const [changeAccountSubscriber, changeAccountCleanup] = builders
13
+ .changeAccountSubscriber(getProvider)
14
+ /*
15
+ * The Ledger Button returns the connected accounts with the active one first.
16
+ * Since we only need the active account, we take the first element.
17
+ */
18
+ .format(async (instance, accounts) => {
19
+ const chainId = await instance.request({ method: 'eth_chainId' });
20
+ return utils.formatAccountsToCAIP([accounts[0]], chainId);
21
+ })
22
+ .build();
23
+
24
+ /*
25
+ * The Ledger provider rejects every method except `eth_requestAccounts` with
26
+ * "Unauthorized" until it is connected, so we must request accounts FIRST to
27
+ * establish the session, and only then switch chain / read the chain id.
28
+ */
29
+ const connect = builders
30
+ .connect()
31
+ .action(async (_context: Context<EvmActions>, chain?: Chain | ChainId) => {
32
+ const provider = getProvider();
33
+
34
+ const accounts = await provider.request({
35
+ method: 'eth_requestAccounts',
36
+ });
37
+
38
+ if (chain) {
39
+ await utils.switchOrAddNetwork(provider, chain);
40
+ }
41
+
42
+ const chainId = await provider.request({
43
+ method: 'eth_chainId',
44
+ });
45
+
46
+ /*
47
+ * The Ledger provider returns the connected accounts with the active one
48
+ * first, so we take the first element as the active account.
49
+ */
50
+ return {
51
+ accounts: utils.formatAccountsToCAIP([accounts[0]], chainId),
52
+ network: chainId,
53
+ };
54
+ })
55
+ .before(changeAccountSubscriber)
56
+ .or(changeAccountCleanup)
57
+ .or(standardizeAndThrowError)
58
+ .build();
59
+
60
+ const disconnect = commonBuilders
61
+ .disconnect<EvmActions>()
62
+ /*
63
+ * Tell the Ledger provider to clear its cached account/chain (see
64
+ * `LedgerEIP1193Provider.disconnect`) so a later reconnect starts clean.
65
+ * It must never make our own disconnect flow fail, hence the guard.
66
+ */
67
+ .before(async () => {
68
+ try {
69
+ /*
70
+ * hub3 types `disconnect` as `() => void`, but the Ledger provider's
71
+ * implementation is async, so cast to await the real promise (and let
72
+ * the catch handle a rejection).
73
+ */
74
+ await (getProvider().disconnect() as unknown as Promise<void>);
75
+ } catch (error) {
76
+ console.error('[ledger-wallet] provider.disconnect failed', error);
77
+ }
78
+ })
79
+ .after(changeAccountCleanup)
80
+ .build();
81
+
82
+ const canEagerConnect = builders
83
+ .canEagerConnect()
84
+ .action(() => {
85
+ return actions.canEagerConnect(getProvider);
86
+ })
87
+ .build();
88
+
89
+ const canSwitchNetwork = builders
90
+ .canSwitchNetwork()
91
+ .action(actions.canSwitchNetwork())
92
+ .build();
93
+
94
+ const getChainId = builders
95
+ .getChainId()
96
+ .action(actions.getChainId(getProvider))
97
+ .build();
98
+
99
+ const evm = new NamespaceBuilder<EvmActions>('EVM', WALLET_ID)
100
+ .action(connect)
101
+ .action(disconnect)
102
+ .action(canEagerConnect)
103
+ .action(canSwitchNetwork)
104
+ .action(getChainId)
105
+ .build();
106
+
107
+ export { evm };
@@ -0,0 +1,98 @@
1
+ import type { Environments } from './types.js';
2
+ import type { ProviderAPI } from '@hub3js/evm';
3
+ import type { EIP6963ProviderDetail } from '@ledgerhq/ledger-wallet-provider';
4
+
5
+ import { ProviderBuilder } from '@hub3js/core';
6
+
7
+ import { metadata, WALLET_ID } from './constants.js';
8
+ import { setProvider } from './ledgerProvider.js';
9
+ import { evm } from './namespaces/evm.js';
10
+
11
+ const LEDGER_PROVIDER_NAME = 'Ledger Wallet';
12
+
13
+ const buildProvider = () =>
14
+ new ProviderBuilder(WALLET_ID)
15
+ .init(function (context, environments: Environments) {
16
+ const [, setState] = context.state();
17
+
18
+ const handleAnnounceProvider = (
19
+ e: CustomEvent<EIP6963ProviderDetail>
20
+ ) => {
21
+ const { provider, info } = e.detail;
22
+
23
+ if (info.name === LEDGER_PROVIDER_NAME) {
24
+ /*
25
+ * hub3 actions/signer consume the EIP-1193 provider as `ProviderAPI`.
26
+ * Ledger's EIP1193Provider and hub3's don't structurally overlap, so
27
+ * cast through `unknown`.
28
+ */
29
+ setProvider(provider as unknown as ProviderAPI);
30
+ setState('installed', true);
31
+ }
32
+ };
33
+
34
+ if (!environments?.dAppIdentifier || !environments?.apiKey) {
35
+ throw new Error(
36
+ 'Ledger Wallet dApp identifier and API key are required'
37
+ );
38
+ }
39
+
40
+ const initializeProvider = async () => {
41
+ /*
42
+ * Load Ledger's runtime and its stylesheet lazily (both resolved from
43
+ * the external `@ledgerhq/ledger-wallet-provider` dependency by the host
44
+ * bundler) so we only pull them in when the provider initializes.
45
+ */
46
+ await import('@ledgerhq/ledger-wallet-provider/styles.css');
47
+ const { initializeLedgerProvider } = await import(
48
+ '@ledgerhq/ledger-wallet-provider'
49
+ );
50
+
51
+ /*
52
+ * Attach the listener BEFORE initializing so we don't race the
53
+ * provider's immediate announce that fires during initialization.
54
+ */
55
+ window.addEventListener(
56
+ 'eip6963:announceProvider',
57
+ handleAnnounceProvider as EventListener
58
+ );
59
+
60
+ const cleanup = initializeLedgerProvider({
61
+ dAppIdentifier: environments.dAppIdentifier,
62
+ apiKey: environments.apiKey,
63
+ loggerLevel: environments.loggerLevel || 'info',
64
+ hideButton: environments.hideButton,
65
+ });
66
+
67
+ /*
68
+ * Ask every EIP-6963 provider to (re-)announce itself. Without this
69
+ * request the listener only ever sees the one-shot announce above.
70
+ */
71
+ window.dispatchEvent(new Event('eip6963:requestProvider'));
72
+
73
+ return cleanup;
74
+ };
75
+
76
+ let cleanup: (() => void) | undefined;
77
+
78
+ initializeProvider()
79
+ .then((cleanupFn) => {
80
+ cleanup = cleanupFn;
81
+ })
82
+ .catch((error) => {
83
+ console.error('[ledger-wallet] failed to initialize provider', error);
84
+ });
85
+
86
+ return () => {
87
+ cleanup?.();
88
+ window.removeEventListener(
89
+ 'eip6963:announceProvider',
90
+ handleAnnounceProvider as EventListener
91
+ );
92
+ };
93
+ })
94
+ .config('metadata', metadata)
95
+ .add('evm', evm)
96
+ .build();
97
+
98
+ export { buildProvider };
package/src/signer.ts ADDED
@@ -0,0 +1,11 @@
1
+ import type { SignerFactory } from 'rango-types';
2
+
3
+ import { DefaultSignerFactory, TransactionType as TxType } from 'rango-types';
4
+
5
+ export default async function getSigners(): Promise<SignerFactory> {
6
+ const signers = new DefaultSignerFactory();
7
+ const { CustomEvmSigner } = await import('./signers/evm.js');
8
+ signers.registerSigner(TxType.EVM, new CustomEvmSigner());
9
+
10
+ return signers;
11
+ }
@@ -0,0 +1,143 @@
1
+ import type { TypedData } from '@rango-dev/signer-evm';
2
+ import type { GenericSigner } from 'rango-types';
3
+ import type { EvmTransaction } from 'rango-types/mainApi';
4
+
5
+ import { cleanEvmError, DefaultEvmSigner } from '@rango-dev/signer-evm';
6
+
7
+ import { getProvider } from '../ledgerProvider.js';
8
+
9
+ const HEXADECIMAL_BASE = 16;
10
+
11
+ /*
12
+ * Ledger's eth_sendTransaction params (see EthSendTransactionParams):
13
+ * - use `gas`, not ethers' `gasLimit`. TransactionHelper only reads
14
+ * `transaction.gas` → ethers gasLimit; a `gasLimit` key is ignored.
15
+ * - quantities should be hex. Ledger parses nonce with parseInt(nonce, 16),
16
+ * so a decimal nonce would be wrong. Hex also keeps fees in JSON-RPC form.
17
+ *
18
+ * If gas + maxFeePerGas + maxPriorityFeePerGas are not all set, Ledger
19
+ * re-estimates and overwrites those three fields (EIP-1559). So for swaps we
20
+ * must pass the full triad when Rango provides EIP-1559 fees; otherwise Rango's
21
+ * gas limit is dropped.
22
+ * https://developers.ledger.com/docs/ledger-wallet-provider/api-reference
23
+ */
24
+ type LedgerTransactionParams = {
25
+ data: string;
26
+ from?: string;
27
+ to?: string;
28
+ value?: string;
29
+ nonce?: string;
30
+ gas?: string;
31
+ gasPrice?: string;
32
+ maxFeePerGas?: string;
33
+ maxPriorityFeePerGas?: string;
34
+ };
35
+
36
+ /** Hex-encode a Rango quantity (`0x…` or decimal string). BigInt accepts both. */
37
+ const toHexQuantity = (value: string): string =>
38
+ '0x' + BigInt(value).toString(HEXADECIMAL_BASE);
39
+
40
+ /*
41
+ * Map Rango's EvmTransaction to Ledger's JSON-RPC shape: gasLimit → gas,
42
+ * quantities hex-encoded, EIP-1559 preferred over legacy gasPrice.
43
+ */
44
+ const buildLedgerTx = (tx: EvmTransaction): LedgerTransactionParams => {
45
+ /*
46
+ * Always send data and value:
47
+ * - data: `0x` instead of undefined (same as DefaultEvmSigner.buildTx).
48
+ * - value: Ledger's internal Transaction type requires value; omit it on
49
+ * zero-value txs (approvals) and fee estimation / serialization can
50
+ * break. Default to 0x0.
51
+ */
52
+ const params: LedgerTransactionParams = {
53
+ data: tx.data || '0x',
54
+ value: tx.value ? toHexQuantity(tx.value) : '0x0',
55
+ };
56
+ if (tx.from) {
57
+ params.from = tx.from;
58
+ }
59
+ if (tx.to) {
60
+ params.to = tx.to;
61
+ }
62
+ if (tx.nonce) {
63
+ params.nonce = toHexQuantity(tx.nonce);
64
+ }
65
+ if (tx.gasLimit) {
66
+ params.gas = toHexQuantity(tx.gasLimit);
67
+ }
68
+ if (tx.maxFeePerGas && tx.maxPriorityFeePerGas) {
69
+ params.maxFeePerGas = toHexQuantity(tx.maxFeePerGas);
70
+ params.maxPriorityFeePerGas = toHexQuantity(tx.maxPriorityFeePerGas);
71
+ } else if (tx.gasPrice) {
72
+ /*
73
+ * Legacy path: Ledger still requires maxFee* to skip re-estimation, so it
74
+ * will overwrite gas/fees with its own EIP-1559 estimate. We only forward
75
+ * gasPrice for wallets that honor it; do not expect Rango's gasLimit to
76
+ * stick on this path.
77
+ */
78
+ params.gasPrice = toHexQuantity(tx.gasPrice);
79
+ }
80
+ return params;
81
+ };
82
+
83
+ /*
84
+ * Implement GenericSigner so signAndSendTx can return only `{ hash }` —
85
+ * Ledger's eth_sendTransaction never yields an ethers TransactionResponse.
86
+ * Delegate personal_sign / eth_signTypedData_v4 to DefaultEvmSigner (supported
87
+ * by Ledger). Do not use its signAndSendTx: ethers then polls
88
+ * eth_getTransactionByHash, which Ledger does not support.
89
+ */
90
+ export class CustomEvmSigner implements GenericSigner<EvmTransaction> {
91
+ private defaultEvmSigner: DefaultEvmSigner;
92
+
93
+ constructor() {
94
+ /*
95
+ * Provider comes from the EIP-6963 announce stashed in ledgerProvider
96
+ * (getSigners runs after connect, so it should already be set).
97
+ */
98
+ this.defaultEvmSigner = new DefaultEvmSigner(getProvider());
99
+ }
100
+
101
+ async signMessage(msg: string): Promise<string> {
102
+ return await this.defaultEvmSigner.signMessage(msg);
103
+ }
104
+
105
+ async signTypedData(typedData: TypedData): Promise<string> {
106
+ return await this.defaultEvmSigner.signTypedData(typedData);
107
+ }
108
+
109
+ async signAndSendTx(
110
+ tx: EvmTransaction,
111
+ /*
112
+ * Unused on purpose:
113
+ * - Ledger eth_sendTransaction does not validate tx.from against the
114
+ * selected account (unlike eth_signTypedData*), so an address check
115
+ * here cannot stop a wrong-account sign.
116
+ * - Network is enforced upstream by
117
+ * checkEnvironmentBeforeExecuteTransaction.
118
+ */
119
+ _address: string,
120
+ _chainId: string | null
121
+ ): Promise<{ hash: string }> {
122
+ try {
123
+ const provider = getProvider();
124
+
125
+ const hash = await provider.request({
126
+ method: 'eth_sendTransaction',
127
+ params: [buildLedgerTx(tx)],
128
+ });
129
+
130
+ return { hash };
131
+ } catch (error) {
132
+ throw cleanEvmError(error);
133
+ }
134
+ }
135
+
136
+ /*
137
+ * Tx is already broadcast; Ledger cannot serve getTransaction/receipts.
138
+ * Return the hash so checkStatus can continue via the API watcher.
139
+ */
140
+ async wait(txHash: string): Promise<{ hash: string }> {
141
+ return { hash: txHash };
142
+ }
143
+ }
package/src/types.ts ADDED
@@ -0,0 +1,6 @@
1
+ export type Environments = {
2
+ dAppIdentifier: string;
3
+ apiKey: string;
4
+ loggerLevel?: 'fatal' | 'error' | 'warn' | 'info' | 'debug';
5
+ hideButton?: boolean;
6
+ };