@multiplatform.one/web3 7.25.0 → 7.28.0

package/README.md

@@ -14,7 +14,8 @@ Peers: `react`, `@tanstack/react-query`.
 
 ## What it owns
 
-- **`WalletProvider`** — wagmi + connectkit setup from one `Web3Config`
+- **`Web3Provider`** (also `WalletProvider`) — the wallet families, the
+  connection store behind `useConnection()`, and wagmi + connectkit, from one `Web3Config`
   (`appName`, `chains`, `enableTestnets`, `localnet` for a hardhat dev chain,
   Solana/Sui RPC URLs)
 - **Hooks** — `useWallet()` (unified state + actions), `useContractRead`,
@@ -22,11 +23,93 @@ Peers: `react`, `@tanstack/react-query`.
   `useBalance`, `useConnect`, `useSignMessage`, `useSwitchChain`, …)
 - **Components** — `ConnectKitButton`, `WalletButton`, `WalletAvatar`,
   `WalletStatus`, `NetworkSwitcher`
-- **Subpaths** — `./native` (WebView wallet bridge), `./connectkit`,
+- **Subpaths** — `./web` (the root without the tamagui components, for a
+  plain web bundler, below), `./native` (WebView wallet bridge), `./connectkit`,
   `./message` (the wallet sign-in messages), `./keycloak` (wallet login
   against the Keycloak wallet SPI), `./vite` and `./esbuild` (bundler
   plugins, below)
 
+## Wallet families and `useConnection()`
+
+`Web3Provider` registers the wallet families an app uses and holds one active
+connection across them. `WalletProvider` is the same component under its first
+name.
+
+```tsx
+import { Web3Provider, eth, gpg, sol, useConnection } from "@multiplatform.one/web3";
+
+function Account() {
+  const { status, family, address, client } = useConnection();
+  if (status !== "connected") return null;
+  return <button onClick={() => client?.signMessage("hello")}>{`${family} ${address}`}</button>;
+}
+
+export function App() {
+  return (
+    <Web3Provider config={{ appName: "My App" }} families={[eth(), sol(), gpg()]}>
+      <Account />
+    </Web3Provider>
+  );
+}
+```
+
+Leave `families` out and the provider takes the ones `config.families` names,
+or every built-in family: `eth`, `sol`, `sui`, `btc` and `gpg`. Pass one or
+the other, not both. Each family carries its sign-in message, which
+`useConnectionStore().registry.messages.build(family, opts)` builds, and its
+connection driver: `eth()` runs on wagmi, and `eth({ config })` hands the
+provider the app's own wagmi config; `sol()`, `sui()` and `btc()` run on the
+light driver in a store an app makes itself with `createConnectionStore`;
+`gpg()` signs without connecting. Under `Web3Provider` the Solana, Sui and
+Bitcoin families connect through the wagmi config for now (below), so a config
+handed over with `eth({ config })` lists their wallets only if it carries the
+Solana, Sui and Bitcoin wallet connectors, as `getDefaultConfig` builds it.
+
+`useConnection()` returns `{ status, family, connector, address, chainId, client }`
+whichever way the connection opened: the connect modal, a wagmi hook, or
+`useConnectionStore().connect(family, connectorId)`. Connecting a wallet of
+another family closes the first. `useEvmClient()`, `useSuiClient()` and
+`useBitcoinClient()` return the store's client when one is mounted.
+
+Until the modal reads the store in 8.0.0, eth, sol, sui and btc connect through
+the modal's wagmi config, and wagmi still restores the last connection on load.
+Solana, Sui and Bitcoin connections report `solana:mainnet`, `sui:mainnet` and
+`bitcoin` as their chain id, not the synthetic EVM id the wagmi shim uses. A
+`ConnectKitProvider` under a bare `WagmiProvider` mounts a store of its own.
+The shim's exports are deprecated and go in 8.0.0: `walletAdapterConnector`,
+`getWalletConnectors`, `syntheticChains`, `solanaChain`, `suiChain`,
+`bitcoinChain`, `SOLANA_CHAIN_ID`, `SUI_CHAIN_ID`, `BITCOIN_CHAIN_ID`,
+`isSyntheticChainId`, `clientForConnector` and `connectorAdapter`.
+
+## Sign-in with `SignInProvider`
+
+`SignInProvider` signs in with whatever the connection store holds: the
+connected family builds its own sign-in message and the connection's client
+signs it, so an Ethereum, Solana, Sui or Bitcoin wallet takes the same path.
+Hand it a nonce source and an `onSign`, or pass the same config as
+`Web3Provider`'s `signIn` prop.
+
+```tsx
+const kc = keycloakWallet({ baseUrl, realm, domain: "app.example.com" });
+const grant = kc.directGrant({ clientId: "app" });
+
+<Web3Provider config={config} signIn={kc.signInConfig(grant.onSign)}>
+  <App />
+</Web3Provider>;
+
+// inside App: useDirectLogin(grant).signIn(), or useSignIn().signIn()
+```
+
+`useSignIn()` returns `{ status, error, signIn, reset }`, whose `status` takes
+`StatusState`'s values. `useDirectLogin` and `useWalletLogin` sign through a
+SignInProvider when there is one. The wagmi-only
+`SIWEProvider`, `useSIWE`, `kc.siweConfig` and `kc.createMessage`, and
+`Web3Provider`'s `siwe` prop, are deprecated and go in 8.0.0; under only a
+`SIWEProvider` the Keycloak hooks sign through it as before.
+`KeycloakWalletLogin` keeps its SIWEProvider until then: the connect modal's
+sign-in step, which a phone lands on after the wallet trip, reads the SIWE
+provider until the modal reads the store.
+
 ## Per-chain clients
 
 Apps talk to a chain through a client, never through wagmi, `window.ethereum`
@@ -36,12 +119,13 @@ or a provider's `request`. Every client shares
 verifiers take: EVM 0x hex, Solana base58, Sui base64, Bitcoin base64 BIP-322,
 GPG the armored signature plus the armored public key.
 
-| Hook / factory                                                                    | What it adds                                                                                                                                                                                                                                                                                                       |
-| --------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `useEvmClient()` / `evmClient({ walletClient } \| { provider, account, chain })`  | viem `walletClient` + `publicClient`, `sendTransaction`, `writeContract`, `waitForTransactionReceipt`, `confirmTransaction`, `explorerTxUrl`, `erc20.{transfer, approve, ensureAllowance, balanceOf, allowance, decimals}`, safe for tokens like USDT that return nothing or refuse a non-zero to non-zero approve |
-| `useSolanaClient()` / `solanaClient({ signer, rpcUrl?, chain? })` from `./solana` | web only: `@solana/kit` `rpc`, `signTransaction`, `signAndSendTransaction`, `sendTransaction`, `confirmTransaction`, `getBalance`, `transferSol`                                                                                                                                                                   |
-| `useGpgSigner()` / `createGpgSigner()`                                            | the copy/paste GPG signer: `signMessage` parks a request with its terminal `command`; `submit(pasted, request)` resolves it only while `request` is still the pending one and the pasted signature covers its message                                                                                              |
-| `useSuiClient()`, `useBitcoinClient()`                                            | message signing only; `signTransaction` / `signPsbt` reject with `UnsupportedClientMethodError` until transactions land                                                                                                                                                                                            |
+| Hook / factory                                                                                                      | What it adds                                                                                                                                                                                                                                                                                                       |
+| ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `useEvmClient()` / `evmClient({ walletClient } \| { provider, account, chain })`                                    | viem `walletClient` + `publicClient`, `sendTransaction`, `writeContract`, `waitForTransactionReceipt`, `confirmTransaction`, `explorerTxUrl`, `erc20.{transfer, approve, ensureAllowance, balanceOf, allowance, decimals}`, safe for tokens like USDT that return nothing or refuse a non-zero to non-zero approve |
+| `useEvmReadClient({ chainId? })` / `evmReadClient({ chain, rpcUrl? })` / `evmReadClients(web3Config).get(chainId?)` | no wallet needed: `publicClient`, `readContract`, `erc20.{balanceOf, allowance, decimals}` with the owner named, `explorerTxUrl`; `address` is null, and `signMessage`, `sendTransaction` and `writeContract` reject with `ReadOnlyClientError`                                                                    |
+| `useSolanaClient()` / `solanaClient({ signer, rpcUrl?, chain? })` from `./solana`                                   | web only: `@solana/kit` `rpc`, `signTransaction`, `signAndSendTransaction`, `sendTransaction`, `confirmTransaction`, `getBalance`, `transferSol`                                                                                                                                                                   |
+| `useGpgSigner()` / `createGpgSigner()`                                                                              | the copy/paste GPG signer: `signMessage` parks a request with its terminal `command`; `submit(pasted, request)` resolves it only while `request` is still the pending one and the pasted signature covers its message                                                                                              |
+| `useSuiClient()`, `useBitcoinClient()`                                                                              | message signing only; `signTransaction` / `signPsbt` reject with `UnsupportedClientMethodError` until transactions land                                                                                                                                                                                            |
 
 ```tsx
 import { useEvmClient } from "@multiplatform.one/web3";
@@ -78,6 +162,29 @@ signs Solana through the WebView bridge, so the root never imports
 through `solanaMessageClient`, so a login page carries no kit.
 `tests/clients/importGraph.spec.ts` holds both lines, for native and web.
 
+### EVM reads without a wallet
+
+Reads that must work before a wallet connects, such as prices, sale state or
+a quote for an anonymous visitor, or a balance on a chain other than the
+connected one, go through a read client. Inside a `WalletProvider`,
+`useEvmReadClient({ chainId })` wraps the provider's own public client for that
+chain. With no `chainId` it follows the chain wagmi is on, which moves when the
+wallet switches network, so pass `chainId` to read a contract that lives on one
+chain. Outside React, `evmReadClients(config)` takes the same `Web3Config`
+chain fields and resolves the same chains and RPCs, localnet included. Both
+clients and `evmClient` have `readContract` and the `erc20` reads, so
+`useEvmClient() ?? useEvmReadClient({ chainId })` reads either way.
+
+```ts
+import { evmReadClients } from "@multiplatform.one/web3";
+
+const readers = evmReadClients({ chains: [base, polygon] });
+const price = await readers
+  .get(base.id)
+  .readContract({ address: sale, abi, functionName: "price" });
+const held = await readers.get(polygon.id).erc20.balanceOf(qcc, visitor);
+```
+
 ### EVM payments: pending is not failed
 
 A sent transaction can sit in the mempool for minutes and still land. viem's
@@ -243,6 +350,30 @@ React Native builds don't need it: the native `WalletProvider` renders the
 wallet UI from `assets/webview.html`, which this package builds with the
 plugin.
 
+## Plain web bundlers: the `./web` entry
+
+The root entry also exports the tamagui components (`WalletButton`,
+`WalletAvatar`, `WalletStatus`, `NetworkSwitcher`, `TransactionStatusComponent`)
+and the `LockContract` example. tamagui's web build imports `react-native-web`,
+and `@multiplatform.one/platform` reads `process.env` at load, so a web-only
+app that imports the root has to install `react-native-web`, alias
+`react-native` to it and define `process.env`.
+
+`@multiplatform.one/web3/web` is everything else the root exports, with none of
+that in its module graph: `WalletProvider`, the hooks, `ConnectKitButton`, the
+per-chain clients, the bridge, the message builder and the core contracts. A
+Vite app or library build needs only the bundler plugin above, plus the
+`process.env.NODE_ENV` define React needs in any library build.
+
+```ts
+import { WalletProvider, evmClient, useEvmClient } from "@multiplatform.one/web3/web";
+```
+
+`web-entry/webEntry.spec.ts` (`pnpm test:web-entry`) holds it to that: it
+builds this import as a Vite app and as an IIFE library with `react-native`
+unresolvable, checks that tamagui, platform and theme stay out of the module
+graph, and mounts `WalletProvider` from the bundle on a page with no `process`.
+
 ## Native apps: the WebView bridge
 
 A native app does not link wallet SDKs. The native `WalletProvider` (the
@@ -271,6 +402,24 @@ if (outcome.status === "signed-in") save(outcome.tokens);
 // to finish the profile; call signIn again once it redirects back.
 ```
 
+Each wallet family names the bridge namespace the page serves it on
+(`family.bridge.namespace`: `evm`, `solana`, `sui`, `gpg`), and a family that
+brings a bridge driver connects across it. On native, `useConnection()`
+reports the store's connection for eth through the bridge's wagmi connector
+and for sol and sui through `solanaBridgeDriver` and `suiBridgeDriver`:
+`useConnectionStore().connect("sol", "webViewSolana")` asks the page's Solana
+wallet, and its client signs base58 as on web. When the page reloads, the
+store asks it for the account again and drops a session the new page does not
+hold. Bitcoin has no bridge namespace yet. A wallet connected straight
+through `useSolanaWallet()` or `useWalletBridge()` stays outside the store.
+
+The `webViewSolana` and `webViewSui` connectors are only as good as the
+page's wallets. Today that is the mock wallet page (E2E): on a phone the
+WebView has no injected Phantom (Solana on mobile, above, is the follow-up)
+and no Wallet Standard Sui wallet, so connecting them fails there, as
+`useSolanaWallet()` does. The native store keeps no record across app
+restarts.
+
 `@multiplatform.one/web3/bridge` is the same bridge without wagmi, for a host
 that drives the page itself. Kotlin and Swift hosts implement
 [docs/bridge-protocol.md](docs/bridge-protocol.md), the versioned wire

package/dist/cjs/bridge/base58.cjs

@@ -0,0 +1,48 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all) __defProp(target, name, {
+    get: all[name],
+    enumerable: true
+  });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from)) if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    });
+  }
+  return to;
+};
+var __toCommonJS = mod => __copyProps(__defProp({}, "__esModule", {
+  value: true
+}), mod);
+var base58_exports = {};
+__export(base58_exports, {
+  bytesToBase58: () => bytesToBase58
+});
+module.exports = __toCommonJS(base58_exports);
+const ALPHABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
+function bytesToBase58(bytes) {
+  let zeros = 0;
+  while (zeros < bytes.length && bytes[zeros] === 0) zeros += 1;
+  const digits = [];
+  for (let i = zeros; i < bytes.length; i += 1) {
+    let carry = bytes[i];
+    for (let j = 0; j < digits.length; j += 1) {
+      carry += digits[j] << 8;
+      digits[j] = carry % 58;
+      carry = Math.floor(carry / 58);
+    }
+    while (carry > 0) {
+      digits.push(carry % 58);
+      carry = Math.floor(carry / 58);
+    }
+  }
+  let out = "1".repeat(zeros);
+  for (let i = digits.length - 1; i >= 0; i -= 1) out += ALPHABET[digits[i]];
+  return out;
+}

package/dist/cjs/bridge/base58.native.js

@@ -0,0 +1,51 @@
+"use strict";
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all) __defProp(target, name, {
+    get: all[name],
+    enumerable: true
+  });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from)) if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    });
+  }
+  return to;
+};
+var __toCommonJS = mod => __copyProps(__defProp({}, "__esModule", {
+  value: true
+}), mod);
+var base58_exports = {};
+__export(base58_exports, {
+  bytesToBase58: () => bytesToBase58
+});
+module.exports = __toCommonJS(base58_exports);
+var ALPHABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
+function bytesToBase58(bytes) {
+  var zeros = 0;
+  while (zeros < bytes.length && bytes[zeros] === 0) zeros += 1;
+  var digits = [];
+  for (var i = zeros; i < bytes.length; i += 1) {
+    var carry = bytes[i];
+    for (var j = 0; j < digits.length; j += 1) {
+      carry += digits[j] << 8;
+      digits[j] = carry % 58;
+      carry = Math.floor(carry / 58);
+    }
+    while (carry > 0) {
+      digits.push(carry % 58);
+      carry = Math.floor(carry / 58);
+    }
+  }
+  var out = "1".repeat(zeros);
+  for (var i1 = digits.length - 1; i1 >= 0; i1 -= 1) out += ALPHABET[digits[i1]];
+  return out;
+}
+//# sourceMappingURL=base58.native.js.map

package/dist/cjs/bridge/base58.native.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["__toCommonJS","mod","__copyProps","__defProp","value","base58_exports","__export","bytesToBase58","module","exports","ALPHABET","bytes","zeros","length","digits","i","carry","j","Math","floor","push","out","repeat","i1"],"sources":["../../../src/bridge/base58.ts"],"sourcesContent":[null],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,YAAA,GAAAC,GAAA,IAAAC,WAAA,CAAAC,SAAA;EAAAC,KAAA;AAAA,IAAAH,GAAA;AAAA,IAAAI,cAAA;AAAAC,QAAA,CAAAD,cAAA;EAAAE,aAAA,EAAAA,CAAA,KAAAA;AAAA;AAGAC,MAAM,CAAAC,OAAA,GAAWT,YAAA,CAAAK,cAAA;AAEV,IAAAK,QAAS,+DAAyC;AACvD,SAAIH,aAAQA,CAAAI,KAAA;EACZ,IAAAC,KAAO;EACP,OAAMA,KAAA,GAAmBD,KAAC,CAAAE,MAAA,IAAAF,KAAA,CAAAC,KAAA,SAAAA,KAAA;EAC1B,IAAAE,MAAS,GAAI;EACX,SAAIC,CAAA,GAAAH,KAAQ,EAAMG,CAAC,GAAAJ,KAAA,CAAAE,MAAA,EAAAE,CAAA;IACnB,IAAAC,KAAS,GAAAL,KAAO,CAAAI,CAAA,CAAI;IAClB,SAAAE,CAAA,GAAS,GAAAA,CAAA,GAAQH,MAAK,CAAAD,MAAA,EAAAI,CAAA;MACtBD,KAAA,IAAQF,MAAI,CAAAG,CAAA,KAAQ;MACpBH,MAAA,CAAAG,CAAQ,IAAAD,KAAK,GAAM;MACrBA,KAAA,GAAAE,IAAA,CAAAC,KAAA,CAAAH,KAAA;IACA;IACE,OAAAA,KAAO,GAAK;MACZF,MAAA,CAAAM,IAAQ,CAAAJ,KAAK,GAAM;MACrBA,KAAA,GAAAE,IAAA,CAAAC,KAAA,CAAAH,KAAA;IACF;EACA;EACA,IAAAK,GAAA,GAAS,GAAI,CAAAC,MAAO,CAAAV,KAAA;EACpB,SAAOW,EAAA,GAAAT,MAAA,CAAAD,MAAA,MAAAU,EAAA,OAAAA,EAAA,OAAAF,GAAA,IAAAX,QAAA,CAAAI,MAAA,CAAAS,EAAA;EACT,OAAAF,GAAA","ignoreList":[]}

package/dist/cjs/bridge/core.cjs

@@ -28,6 +28,7 @@ __export(core_exports, {
   BridgeHost: () => import_BridgeHost.BridgeHost,
   DEV_HOSTNAMES: () => import_hosting.DEV_HOSTNAMES,
   GpgBridge: () => import_GpgBridge.GpgBridge,
+  NativeBridgeErrorCode: () => import_nativeHost.NativeBridgeErrorCode,
   SolanaBridge: () => import_SolanaBridge.SolanaBridge,
   SuiBridge: () => import_SuiBridge.SuiBridge,
   WALLET_SCHEMES: () => import_deepLink.WALLET_SCHEMES,
@@ -45,7 +46,9 @@ __export(core_exports, {
   parseOrigin: () => import_hosting.parseOrigin,
   parseWalletReturn: () => import_deepLink.parseWalletReturn,
   queryParams: () => import_hosting.queryParams,
-  shouldOpenExternally: () => import_deepLink.shouldOpenExternally
+  shouldOpenExternally: () => import_deepLink.shouldOpenExternally,
+  solanaBridgeDriver: () => import_drivers.solanaBridgeDriver,
+  suiBridgeDriver: () => import_drivers.suiBridgeDriver
 });
 module.exports = __toCommonJS(core_exports);
 __reExport(core_exports, require("./protocol.cjs"), module.exports);
@@ -59,6 +62,7 @@ var import_base64 = require("./base64.cjs");
 var import_SolanaBridge = require("./SolanaBridge.cjs");
 var import_SuiBridge = require("./SuiBridge.cjs");
 var import_GpgBridge = require("./GpgBridge.cjs");
+var import_drivers = require("./drivers.cjs");
 var import_AuthBridge = require("./AuthBridge.cjs");
 var import_hosting = require("./hosting.cjs");
 var import_nativeHost = require("./nativeHost.cjs");

package/dist/cjs/bridge/core.native.js

@@ -30,6 +30,7 @@ __export(core_exports, {
   BridgeHost: () => import_BridgeHost.BridgeHost,
   DEV_HOSTNAMES: () => import_hosting.DEV_HOSTNAMES,
   GpgBridge: () => import_GpgBridge.GpgBridge,
+  NativeBridgeErrorCode: () => import_nativeHost.NativeBridgeErrorCode,
   SolanaBridge: () => import_SolanaBridge.SolanaBridge,
   SuiBridge: () => import_SuiBridge.SuiBridge,
   WALLET_SCHEMES: () => import_deepLink.WALLET_SCHEMES,
@@ -47,7 +48,9 @@ __export(core_exports, {
   parseOrigin: () => import_hosting.parseOrigin,
   parseWalletReturn: () => import_deepLink.parseWalletReturn,
   queryParams: () => import_hosting.queryParams,
-  shouldOpenExternally: () => import_deepLink.shouldOpenExternally
+  shouldOpenExternally: () => import_deepLink.shouldOpenExternally,
+  solanaBridgeDriver: () => import_drivers.solanaBridgeDriver,
+  suiBridgeDriver: () => import_drivers.suiBridgeDriver
 });
 module.exports = __toCommonJS(core_exports);
 __reExport(core_exports, require("./protocol.native.js"), module.exports);
@@ -61,6 +64,7 @@ var import_base64 = require("./base64.native.js");
 var import_SolanaBridge = require("./SolanaBridge.native.js");
 var import_SuiBridge = require("./SuiBridge.native.js");
 var import_GpgBridge = require("./GpgBridge.native.js");
+var import_drivers = require("./drivers.native.js");
 var import_AuthBridge = require("./AuthBridge.native.js");
 var import_hosting = require("./hosting.native.js");
 var import_nativeHost = require("./nativeHost.native.js");

package/dist/cjs/bridge/core.native.js.map

@@ -1 +1 @@
-{"version":3,"names":["__toCommonJS","mod","__copyProps","__defProp","value","core_exports","__export","AuthBridge","import_AuthBridge","BridgeClient","import_BridgeClient","BridgeHost","import_BridgeHost","DEV_HOSTNAMES","import_hosting","GpgBridge","import_GpgBridge","SolanaBridge","import_SolanaBridge","SuiBridge","import_SuiBridge","WALLET_SCHEMES","import_deepLink","WALLET_UNIVERSAL_HOSTS","base64ToBytes","import_base64","buildInjectScript","import_nativeHost","bytesToBase64","createBridgeProvider","import_eip1193","createNativeBridge","createPostMessageTransport","import_postMessageTransport","decideNavigation","decideNewWindow","hostedPageOrigin","isHostedPageUrl","parseOrigin","parseWalletReturn","queryParams","shouldOpenExternally","module","exports","__reExport","require"],"sources":["../../../src/bridge/core.ts"],"sourcesContent":[null],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,YAAA,GAAAC,GAAA,IAAAC,WAAA,CAAAC,SAAA;EAAAC,KAAA;AAAA,IAAAH,GAAA;AAAA,IAAAI,YAAA;AAAAC,QAAA,CAAAD,YAAA;EAAAE,UAAA,EAAAA,CAAA,KAAAC,iBAAA,CAAAD,UAAA;EAAAE,YAAA,EAAAA,CAAA,KAAAC,mBAAA,CAAAD,YAAA;EAAAE,UAAA,EAAAA,CAAA,KAAAC,iBAAA,CAAAD,UAAA;EAAAE,aAAA,EAAAA,CAAA,KAAAC,cAAA,CAAAD,aAAA;EAAAE,SAAA,EAAAA,CAAA,KAAAC,gBAAA,CAAAD,SAAA;EAAAE,YAAA,EAAAA,CAAA,KAAAC,mBAAA,CAAAD,YAAA;EAAAE,SAAA,EAAAA,CAAA,KAAAC,gBAAA,CAAAD,SAAA;EAAAE,cAAA,EAAAA,CAAA,KAAAC,eAAA,CAAAD,cAAA;EAAAE,sBAAA,EAAAA,CAAA,KAAAD,eAAA,CAAAC,sBAAA;EAAAC,aAAA,EAAAA,CAAA,KAAAC,aAAA,CAAAD,aAAA;EAAAE,iBAAA,EAAAA,CAAA,KAAAC,iBAAA,CAAAD,iBAAA;EAAAE,aAAA,EAAAA,CAAA,KAAAH,aAAA,CAAAG,aAAA;EAAAC,oBAAA,EAAAA,CAAA,KAAAC,cAAA,CAAAD,oBAAA;EAAAE,kBAAA,EAAAA,CAAA,KAAAJ,iBAAA,CAAAI,kBAAA;EAAAC,0BAAA,EAAAA,CAAA,KAAAC,2BAAA,CAAAD,0BAAA;EAAAE,gBAAA,EAAAA,CAAA,KAAAZ,eAAA,CAAAY,gBAAA;EAAAC,eAAA,EAAAA,CAAA,KAAAb,eAAA,CAAAa,eAAA;EAAAC,gBAAA,EAAAA,CAAA,KAAAtB,cAAA,CAAAsB,gBAAA;EAAAC,eAAA,EAAAA,CAAA,KAAAvB,cAAA,CAAAuB,eAAA;EAAAC,WAAA,EAAAA,CAAA,KAAAxB,cAAA,CAAAwB,WAAA;EAAAC,iBAAA,EAAAA,CAAA,KAAAjB,eAAA,CAAAiB,iBAAA;EAAAC,WAAA,EAAAA,CAAA,KAAA1B,cAAA,CAAA0B,WAAA;EAAAC,oBAAA,EAAAA,CAAA,KAAAnB,eAAA,CAAAmB;AAAA;AAEAC,MAAA,CAAAC,OAAA,GAAA3C,YAAc,CAAAK,YAAA;AACduC,UAAA,CAAAvC,YAAA,EAAcwC,OAAA,0BAAAH,MAHd,CAAAC,OAAA;AAIAC,UAAA,CAAAvC,YAAA,EAAcwC,OAAA,2BAJdH,MAAA,CAAAC,OAAA;AAKAC,UAAA,CAAAvC,YAAA,EAAAwC,OAAA,wBAAsE,GAAAH,MAAA,CAAAC,OAAA;AACtE,IAAAV,2BAAqE,GAAAY,OAAA;AACrE,IAAAnC,mBAAA,GAAgDmC,OAAA;AAChD,IAAAjC,iBAAmF,GAAAiC,OAAA;AACnF,IAAAf,cAAA,GAA6Ce,OAAA;AAC7C,IAAApB,aAAA,GAAAoB,OAA6B;AAC7B,IAAA3B,mBAA0B,GAAA2B,OAAA;AAC1B,IAAAzB,gBAAA,GAAkDyB,OAAA;AAClD,IAAA7B,gBAAA,GAAA6B,OAKO;AACP,IAAArC,iBAOO,GAAAqC,OAAA;AACP,IAAA/B,cAAA,GAAA+B,OAKO;AACP,IAAAlB,iBAAA,GAQOkB,OAAA","ignoreList":[]}
+{"version":3,"names":["__toCommonJS","mod","__copyProps","__defProp","value","core_exports","__export","AuthBridge","import_AuthBridge","BridgeClient","import_BridgeClient","BridgeHost","import_BridgeHost","DEV_HOSTNAMES","import_hosting","GpgBridge","import_GpgBridge","NativeBridgeErrorCode","import_nativeHost","SolanaBridge","import_SolanaBridge","SuiBridge","import_SuiBridge","WALLET_SCHEMES","import_deepLink","WALLET_UNIVERSAL_HOSTS","base64ToBytes","import_base64","buildInjectScript","bytesToBase64","createBridgeProvider","import_eip1193","createNativeBridge","createPostMessageTransport","import_postMessageTransport","decideNavigation","decideNewWindow","hostedPageOrigin","isHostedPageUrl","parseOrigin","parseWalletReturn","queryParams","shouldOpenExternally","solanaBridgeDriver","import_drivers","suiBridgeDriver","module","exports","__reExport","require"],"sources":["../../../src/bridge/core.ts"],"sourcesContent":[null],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,YAAA,GAAAC,GAAA,IAAAC,WAAA,CAAAC,SAAA;EAAAC,KAAA;AAAA,IAAAH,GAAA;AAAA,IAAAI,YAAA;AAAAC,QAAA,CAAAD,YAAA;EAAAE,UAAA,EAAAA,CAAA,KAAAC,iBAAA,CAAAD,UAAA;EAAAE,YAAA,EAAAA,CAAA,KAAAC,mBAAA,CAAAD,YAAA;EAAAE,UAAA,EAAAA,CAAA,KAAAC,iBAAA,CAAAD,UAAA;EAAAE,aAAA,EAAAA,CAAA,KAAAC,cAAA,CAAAD,aAAA;EAAAE,SAAA,EAAAA,CAAA,KAAAC,gBAAA,CAAAD,SAAA;EAAAE,qBAAA,EAAAA,CAAA,KAAAC,iBAAA,CAAAD,qBAAA;EAAAE,YAAA,EAAAA,CAAA,KAAAC,mBAAA,CAAAD,YAAA;EAAAE,SAAA,EAAAA,CAAA,KAAAC,gBAAA,CAAAD,SAAA;EAAAE,cAAA,EAAAA,CAAA,KAAAC,eAAA,CAAAD,cAAA;EAAAE,sBAAA,EAAAA,CAAA,KAAAD,eAAA,CAAAC,sBAAA;EAAAC,aAAA,EAAAA,CAAA,KAAAC,aAAA,CAAAD,aAAA;EAAAE,iBAAA,EAAAA,CAAA,KAAAV,iBAAA,CAAAU,iBAAA;EAAAC,aAAA,EAAAA,CAAA,KAAAF,aAAA,CAAAE,aAAA;EAAAC,oBAAA,EAAAA,CAAA,KAAAC,cAAA,CAAAD,oBAAA;EAAAE,kBAAA,EAAAA,CAAA,KAAAd,iBAAA,CAAAc,kBAAA;EAAAC,0BAAA,EAAAA,CAAA,KAAAC,2BAAA,CAAAD,0BAAA;EAAAE,gBAAA,EAAAA,CAAA,KAAAX,eAAA,CAAAW,gBAAA;EAAAC,eAAA,EAAAA,CAAA,KAAAZ,eAAA,CAAAY,eAAA;EAAAC,gBAAA,EAAAA,CAAA,KAAAvB,cAAA,CAAAuB,gBAAA;EAAAC,eAAA,EAAAA,CAAA,KAAAxB,cAAA,CAAAwB,eAAA;EAAAC,WAAA,EAAAA,CAAA,KAAAzB,cAAA,CAAAyB,WAAA;EAAAC,iBAAA,EAAAA,CAAA,KAAAhB,eAAA,CAAAgB,iBAAA;EAAAC,WAAA,EAAAA,CAAA,KAAA3B,cAAA,CAAA2B,WAAA;EAAAC,oBAAA,EAAAA,CAAA,KAAAlB,eAAA,CAAAkB,oBAAA;EAAAC,kBAAA,EAAAA,CAAA,KAAAC,cAAA,CAAAD,kBAAA;EAAAE,eAAA,EAAAA,CAAA,KAAAD,cAAA,CAAAC;AAAA;AAEAC,MAAA,CAAAC,OAAA,GAAA/C,YAAc,CAAAK,YAAA;AACd2C,UAAA,CAAA3C,YAAA,EAAc4C,OAAA,0BAAAH,MAHd,CAAAC,OAAA;AAIAC,UAAA,CAAA3C,YAAA,EAAc4C,OAAA,2BAJdH,MAAA,CAAAC,OAAA;AAKAC,UAAA,CAAA3C,YAAA,EAAA4C,OAAA,wBAAsE,GAAAH,MAAA,CAAAC,OAAA;AACtE,IAAAb,2BAAqE,GAAAe,OAAA;AACrE,IAAAvC,mBAAA,GAAgDuC,OAAA;AAChD,IAAArC,iBAAmF,GAAAqC,OAAA;AACnF,IAAAlB,cAAA,GAA6CkB,OAAA;AAC7C,IAAAtB,aAAA,GAAAsB,OAA6B;AAC7B,IAAA7B,mBAA0B,GAAA6B,OAAA;AAC1B,IAAA3B,gBAAA,GAAkD2B,OAAA;AAClD,IAAAjC,gBAAA,GAAoFiC,OAAA;AACpF,IAAAL,cAAA,GAAAK,OAKO;AACP,IAAAzC,iBAOO,GAAAyC,OAAA;AACP,IAAAnC,cAAA,GAAAmC,OAMO;AACP,IAAA/B,iBAAA,GAQO+B,OAAA","ignoreList":[]}

package/dist/cjs/bridge/drivers.cjs

@@ -0,0 +1,141 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all) __defProp(target, name, {
+    get: all[name],
+    enumerable: true
+  });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from)) if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    });
+  }
+  return to;
+};
+var __toCommonJS = mod => __copyProps(__defProp({}, "__esModule", {
+  value: true
+}), mod);
+var drivers_exports = {};
+__export(drivers_exports, {
+  solanaBridgeDriver: () => solanaBridgeDriver,
+  solanaBridgeWallet: () => solanaBridgeWallet,
+  suiBridgeDriver: () => suiBridgeDriver,
+  suiBridgeWallet: () => suiBridgeWallet
+});
+module.exports = __toCommonJS(drivers_exports);
+var import_solanaMessage = require("../clients/solanaMessage.cjs");
+var import_sui = require("../clients/sui.cjs");
+var import_lightDriver = require("../core/lightDriver.cjs");
+var import_base64 = require("./base64.cjs");
+var import_base58 = require("./base58.cjs");
+function bridgeWallet(bridge, spec, {
+  id,
+  name
+}) {
+  const read = value => {
+    const address = value?.[spec.key];
+    return typeof address === "string" && address ? address : null;
+  };
+  const adapter = {
+    address: null,
+    async connect() {
+      const address = read(await bridge.request(spec.namespace, "connect"));
+      if (!address) throw new Error(`${name} connected no account`);
+      adapter.address = address;
+    },
+    async disconnect() {
+      adapter.address = null;
+      await bridge.request(spec.namespace, "disconnect");
+    },
+    // A page older than the account method answers it with an error, which
+    // the store reads as "cannot tell yet" and keeps the connection to restore.
+    async restore() {
+      adapter.address = read(await bridge.request(spec.namespace, "account"));
+      return adapter.address !== null;
+    },
+    subscribe(listener) {
+      let live = true;
+      let latest = 0;
+      const off = bridge.on((ns, method, params) => {
+        if (ns === spec.namespace && method === "accountChanged") {
+          latest += 1;
+          adapter.address = read(params);
+          listener();
+        } else if (ns === "sys" && method === "ready") {
+          const asked = ++latest;
+          bridge.request(spec.namespace, "account").then(answer => {
+            if (!live || asked !== latest) return;
+            adapter.address = read(answer);
+            listener();
+          },
+          // A page older than the account method: its own events have to say.
+          () => void 0);
+        }
+      });
+      return () => {
+        live = false;
+        off();
+      };
+    },
+    signMessage: message => spec.sign(bridge, message)
+  };
+  return {
+    id,
+    name,
+    adapter
+  };
+}
+const solana = {
+  namespace: "solana",
+  key: "publicKey",
+  async sign(bridge, message) {
+    const answer = await bridge.request("solana", "signMessage", {
+      message: (0, import_base64.bytesToBase64)(new TextEncoder().encode(message))
+    });
+    return (0, import_base58.bytesToBase58)((0, import_base64.base64ToBytes)(answer.signature));
+  }
+};
+const sui = {
+  namespace: "sui",
+  key: "address",
+  async sign(bridge, message) {
+    const answer = await bridge.request("sui", "signMessage", {
+      message
+    });
+    return answer.signature;
+  }
+};
+function solanaBridgeDriver(bridge, options = {}) {
+  const chain = options.chain ?? "solana:mainnet";
+  const wallets = [solanaBridgeWallet(bridge)];
+  return (0, import_lightDriver.lightDriver)({
+    wallets: () => wallets,
+    chainId: chain,
+    client: wallet => (0, import_solanaMessage.solanaMessageClient)(wallet.adapter, chain)
+  });
+}
+function suiBridgeDriver(bridge) {
+  const wallets = [suiBridgeWallet(bridge)];
+  return (0, import_lightDriver.lightDriver)({
+    wallets: () => wallets,
+    chainId: "sui:mainnet",
+    client: wallet => (0, import_sui.suiClient)(wallet.adapter)
+  });
+}
+function solanaBridgeWallet(bridge, options = {
+  id: "webViewSolana",
+  name: "Solana Wallet"
+}) {
+  return bridgeWallet(bridge, solana, options);
+}
+function suiBridgeWallet(bridge, options = {
+  id: "webViewSui",
+  name: "Sui Wallet"
+}) {
+  return bridgeWallet(bridge, sui, options);
+}