@multiplatform.one/web3 7.25.0 → 7.26.0

package/dist/jsx/core/types.native.js

@@ -0,0 +1,21 @@
+"use strict";
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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 types_exports = {};
+module.exports = __toCommonJS(types_exports);
+//# sourceMappingURL=types.native.js.map

package/dist/jsx/core/types.native.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":[],"sourcesContent":[],"mappings":"","ignoreList":[]}

package/dist/jsx/index.js

@@ -6,5 +6,6 @@ import { mainnet, polygon, optimism, arbitrum, base, sepolia } from "wagmi/chain
 export * from "./bridge/index.mjs";
 export * from "./message/index.mjs";
 export * from "./clients/index.mjs";
+export * from "./core/index.mjs";
 export { ConnectKitButton, LockContract, NetworkSwitcher, TransactionStatus as TransactionStatusComponent, WalletAvatar, WalletButton, WalletProvider, WalletStatus, arbitrum, base, defaultChains, lockAbi, mainnet, optimism, polygon, sepolia, useAccount, useBalance, useBlockNumber, useChainId, useChains, useConnect, useContractRead, useContractWrite, useDisconnect, useEnsAvatar, useEnsName, useReadContract, useSignMessage, useSimulateContract, useSwitchChain, useWaitForTransactionReceipt, useWallet, useWalletBridge, useWeb3Config, useWriteContract };
 //# sourceMappingURL=index.js.map

package/dist/jsx/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["WalletProvider","useWeb3Config","defaultChains","useWalletBridge","useWallet","useContractRead","useContractWrite","useAccount","useBalance","useChainId","useChains","useConnect","useDisconnect","useEnsAvatar","useEnsName","useSignMessage","useSwitchChain","useBlockNumber","useReadContract","useWriteContract","useSimulateContract","useWaitForTransactionReceipt","WalletButton","WalletAvatar","WalletStatus","NetworkSwitcher","TransactionStatus","ConnectKitButton","LockContract","lockAbi","mainnet","polygon","optimism","arbitrum","base","sepolia"],"sources":["../../src/index.ts"],"sourcesContent":[null],"mappings":"AACA,SACEA,cAAA,EACAC,aAAA,EACAC,aAAA,EACAC,eAAA,QAIK;AAGP,SACEC,SAAA,EAKAC,eAAA,EACAC,gBAAA,EAOAC,UAAA,EACAC,UAAA,EACAC,UAAA,EACAC,SAAA,EACAC,UAAA,EACAC,aAAA,EACAC,YAAA,EACAC,UAAA,EACAC,cAAA,EACAC,cAAA,EACAC,cAAA,EACAC,eAAA,EACAC,gBAAA,EACAC,mBAAA,EACAC,4BAAA,QACK;AAGP,SACEC,YAAA,EACAC,YAAA,EACAC,YAAA,EACAC,eAAA,EACqBC,iBAAA,EACrBC,gBAAA,QAMK;AAGP,SAASC,YAAA,EAAcC,OAAA,QAAuC;AAI9D,SAASC,OAAA,EAASC,OAAA,EAASC,QAAA,EAAUC,QAAA,EAAUC,IAAA,EAAMC,OAAA,QAAe;AAGpE,cAAc;AAGd,cAAc;AAId,cAAc","ignoreList":[]}
+{"version":3,"names":["WalletProvider","useWeb3Config","defaultChains","useWalletBridge","useWallet","useContractRead","useContractWrite","useAccount","useBalance","useChainId","useChains","useConnect","useDisconnect","useEnsAvatar","useEnsName","useSignMessage","useSwitchChain","useBlockNumber","useReadContract","useWriteContract","useSimulateContract","useWaitForTransactionReceipt","WalletButton","WalletAvatar","WalletStatus","NetworkSwitcher","TransactionStatus","ConnectKitButton","LockContract","lockAbi","mainnet","polygon","optimism","arbitrum","base","sepolia"],"sources":["../../src/index.ts"],"sourcesContent":[null],"mappings":"AACA,SACEA,cAAA,EACAC,aAAA,EACAC,aAAA,EACAC,eAAA,QAIK;AAGP,SACEC,SAAA,EAKAC,eAAA,EACAC,gBAAA,EAOAC,UAAA,EACAC,UAAA,EACAC,UAAA,EACAC,SAAA,EACAC,UAAA,EACAC,aAAA,EACAC,YAAA,EACAC,UAAA,EACAC,cAAA,EACAC,cAAA,EACAC,cAAA,EACAC,eAAA,EACAC,gBAAA,EACAC,mBAAA,EACAC,4BAAA,QACK;AAGP,SACEC,YAAA,EACAC,YAAA,EACAC,YAAA,EACAC,eAAA,EACqBC,iBAAA,EACrBC,gBAAA,QAMK;AAGP,SAASC,YAAA,EAAcC,OAAA,QAAuC;AAI9D,SAASC,OAAA,EAASC,OAAA,EAASC,QAAA,EAAUC,QAAA,EAAUC,IAAA,EAAMC,OAAA,QAAe;AAGpE,cAAc;AAGd,cAAc;AAId,cAAc;AASd,cAAc","ignoreList":[]}

package/dist/jsx/index.mjs

@@ -6,5 +6,6 @@ import { mainnet, polygon, optimism, arbitrum, base, sepolia } from "wagmi/chain
 export * from "./bridge/index.mjs";
 export * from "./message/index.mjs";
 export * from "./clients/index.mjs";
+export * from "./core/index.mjs";
 export { ConnectKitButton, LockContract, NetworkSwitcher, TransactionStatus as TransactionStatusComponent, WalletAvatar, WalletButton, WalletProvider, WalletStatus, arbitrum, base, defaultChains, lockAbi, mainnet, optimism, polygon, sepolia, useAccount, useBalance, useBlockNumber, useChainId, useChains, useConnect, useContractRead, useContractWrite, useDisconnect, useEnsAvatar, useEnsName, useReadContract, useSignMessage, useSimulateContract, useSwitchChain, useWaitForTransactionReceipt, useWallet, useWalletBridge, useWeb3Config, useWriteContract };
 //# sourceMappingURL=index.mjs.map

package/dist/jsx/index.mjs.map

@@ -1 +1 @@
-{"version":3,"names":["WalletProvider","useWeb3Config","defaultChains","useWalletBridge","useWallet","useContractRead","useContractWrite","useAccount","useBalance","useChainId","useChains","useConnect","useDisconnect","useEnsAvatar","useEnsName","useSignMessage","useSwitchChain","useBlockNumber","useReadContract","useWriteContract","useSimulateContract","useWaitForTransactionReceipt","WalletButton","WalletAvatar","WalletStatus","NetworkSwitcher","TransactionStatus","ConnectKitButton","LockContract","lockAbi","mainnet","polygon","optimism","arbitrum","base","sepolia"],"sources":["../../src/index.ts"],"sourcesContent":[null],"mappings":"AACA,SACEA,cAAA,EACAC,aAAA,EACAC,aAAA,EACAC,eAAA,QAIK;AAGP,SACEC,SAAA,EAKAC,eAAA,EACAC,gBAAA,EAOAC,UAAA,EACAC,UAAA,EACAC,UAAA,EACAC,SAAA,EACAC,UAAA,EACAC,aAAA,EACAC,YAAA,EACAC,UAAA,EACAC,cAAA,EACAC,cAAA,EACAC,cAAA,EACAC,eAAA,EACAC,gBAAA,EACAC,mBAAA,EACAC,4BAAA,QACK;AAGP,SACEC,YAAA,EACAC,YAAA,EACAC,YAAA,EACAC,eAAA,EACqBC,iBAAA,EACrBC,gBAAA,QAMK;AAGP,SAASC,YAAA,EAAcC,OAAA,QAAuC;AAI9D,SAASC,OAAA,EAASC,OAAA,EAASC,QAAA,EAAUC,QAAA,EAAUC,IAAA,EAAMC,OAAA,QAAe;AAGpE,cAAc;AAGd,cAAc;AAId,cAAc","ignoreList":[]}
+{"version":3,"names":["WalletProvider","useWeb3Config","defaultChains","useWalletBridge","useWallet","useContractRead","useContractWrite","useAccount","useBalance","useChainId","useChains","useConnect","useDisconnect","useEnsAvatar","useEnsName","useSignMessage","useSwitchChain","useBlockNumber","useReadContract","useWriteContract","useSimulateContract","useWaitForTransactionReceipt","WalletButton","WalletAvatar","WalletStatus","NetworkSwitcher","TransactionStatus","ConnectKitButton","LockContract","lockAbi","mainnet","polygon","optimism","arbitrum","base","sepolia"],"sources":["../../src/index.ts"],"sourcesContent":[null],"mappings":"AACA,SACEA,cAAA,EACAC,aAAA,EACAC,aAAA,EACAC,eAAA,QAIK;AAGP,SACEC,SAAA,EAKAC,eAAA,EACAC,gBAAA,EAOAC,UAAA,EACAC,UAAA,EACAC,UAAA,EACAC,SAAA,EACAC,UAAA,EACAC,aAAA,EACAC,YAAA,EACAC,UAAA,EACAC,cAAA,EACAC,cAAA,EACAC,cAAA,EACAC,eAAA,EACAC,gBAAA,EACAC,mBAAA,EACAC,4BAAA,QACK;AAGP,SACEC,YAAA,EACAC,YAAA,EACAC,YAAA,EACAC,eAAA,EACqBC,iBAAA,EACrBC,gBAAA,QAMK;AAGP,SAASC,YAAA,EAAcC,OAAA,QAAuC;AAI9D,SAASC,OAAA,EAASC,OAAA,EAASC,QAAA,EAAUC,QAAA,EAAUC,IAAA,EAAMC,OAAA,QAAe;AAGpE,cAAc;AAGd,cAAc;AAId,cAAc;AASd,cAAc","ignoreList":[]}

package/dist/jsx/index.native.js

@@ -71,4 +71,5 @@ var import_chains = require("wagmi/chains");
 __reExport(index_exports, require("./bridge/index.native.js"), module.exports);
 __reExport(index_exports, require("./message/index.native.js"), module.exports);
 __reExport(index_exports, require("./clients/index.native.js"), module.exports);
+__reExport(index_exports, require("./core/index.native.js"), module.exports);
 //# sourceMappingURL=index.native.js.map

package/dist/jsx/index.native.js.map

@@ -1 +1 @@
-{"version":3,"names":["__defProp","Object","defineProperty","__getOwnPropDesc","getOwnPropertyDescriptor","__getOwnPropNames","getOwnPropertyNames","__hasOwnProp","prototype","hasOwnProperty","__export","target","all","name","get","enumerable","__copyProps","to","from","except","desc","key","call","__reExport","mod","secondTarget","__toCommonJS","value","index_exports","ConnectKitButton","import_components","LockContract","import_examples","NetworkSwitcher","TransactionStatusComponent","TransactionStatus","WalletAvatar","WalletButton","WalletProvider","import_providers","WalletStatus","arbitrum","import_chains","base","defaultChains","lockAbi","mainnet","optimism","polygon","sepolia","useAccount","import_hooks","useBalance"],"sources":["../../src/index.ts"],"sourcesContent":[null],"mappings":"AACA;;AAAA,IACEA,SAAA,GAAAC,MAAA,CAAAC,cAAA;AAAA,IACAC,gBAAA,GAAAF,MAAA,CAAAG,wBAAA;AAAA,IACAC,iBAAA,GAAAJ,MAAA,CAAAK,mBAAA;AAAA,IACAC,YAAA,GAAAN,MAAA,CAAAO,SAAA,CAAAC,cAAA;AAAA,IAAAC,QAIK,GAAAA,CAAAC,MAAA,EAAAC,GAAA;EAGP,SAAAC,IAAA,IAAAD,GAAA,EACEZ,SAAA,CAAAW,MAAA,EAAAE,IAAA;IAAAC,GAAA,EAAAF,GAAA,CAAAC,IAAA;IAAAE,UAAA;EAAA;AAAA;AAKA,IACAC,WAAA,GAAAA,CAAAC,EAAA,EAAAC,IAAA,EAAAC,MAAA,EAAAC,IAAA;EAOA,IAAAF,IAAA,WAAAA,IAAA,wBAAAA,IAAA;IACA,SAAAG,GAAA,IAAAhB,iBAAA,CAAAa,IAAA,GACA,KAAAX,YAAA,CAAAe,IAAA,CAAAL,EAAA,EAAAI,GAAA,KAAAA,GAAA,KAAAF,MAAA,EACAnB,SAAA,CAAAiB,EAAA,EAAAI,GAAA;MAAAP,GAAA,EAAAA,CAAA,KAAAI,IAAA,CAAAG,GAAA;MAAAN,UAAA,IAAAK,IAAA,GAAAjB,gBAAA,CAAAe,IAAA,EAAAG,GAAA,MAAAD,IAAA,CAAAL;IAAA;EACA;EACA,OAAAE,EAAA;AAAA;AACA,IACAM,UAAA,GAAAA,CAAAZ,MAAA,EAAAa,GAAA,EAAAC,YAAA,MAAAT,WAAA,CAAAL,MAAA,EAAAa,GAAA,cAAAC,YAAA,IAAAT,WAAA,CAAAS,YAAA,EAAAD,GAAA;AAAA,IACAE,YAAA,GAAAF,GAAA,IAAAR,WAAA,CAAAhB,SAAA;EAAA2B,KAAA;AAAA,IAAAH,GAAA;AAAA,IACAI,aAAA;AAAAlB,QACA,CAAAkB,aAAA;EACAC,gBAAA,EAAAA,CAAA,KAAAC,iBAAA,CAAAD,gBAAA;EACAE,YAAA,EAAAA,CAAA,KAAAC,eAAA,CAAAD,YAAA;EACAE,eAAA,EAAAA,CAAA,KAAAH,iBAAA,CAAAG,eAAA;EACAC,0BAAA,EAAAA,CAAA,KAAAJ,iBAAA,CAAAK,iBAAA;EAAAC,YACK,EAAAA,CAAA,KAAAN,iBAAA,CAAAM,YAAA;EAGPC,YAAA,EAAAA,CAAA,KAAAP,iBAAA,CAAAO,YAAA;EACEC,cAAA,EAAAA,CAAA,KAAAC,gBAAA,CAAAD,cAAA;EACAE,YAAA,EAAAA,CAAA,KAAAV,iBAAA,CAAAU,YAAA;EACAC,QAAA,EAAAA,CAAA,KAAAC,aAAA,CAAAD,QAAA;EACAE,IAAA,EAAAA,CAAA,KAAAD,aAAA,CAAAC,IAAA;EACqBC,aAAA,EAAAA,CAAA,KAAAL,gBAAA,CAAAK,aAAA;EACrBC,OAAA,EAAAA,CAAA,KAAAb,eAAA,CAAAa,OAAA;EAAAC,OAMK,EAAAA,CAAA,KAAAJ,aAAA,CAAAI,OAAA;EAGPC,QAAS,EAAAA,CAAA,KAAAL,aAAc,CAAAK,QAAuC;EAI9DC,OAAS,EAAAA,CAAA,KAAAN,aAAkB,CAAAM,OAAU;EAGrCC,OAAA,EAAAA,CAAA,KAAcP,aAAA,CAAAO,OAAA;EAGdC,UAAA,EAAcA,CAAA,KAAAC,YAAA,CAAAD,UAAA;EAIdE,UAAA,EAAcA,CAAA,KAAAD,YAAA,CAAAC,UAAA","ignoreList":[]}
+{"version":3,"names":["__defProp","Object","defineProperty","__getOwnPropDesc","getOwnPropertyDescriptor","__getOwnPropNames","getOwnPropertyNames","__hasOwnProp","prototype","hasOwnProperty","__export","target","all","name","get","enumerable","__copyProps","to","from","except","desc","key","call","__reExport","mod","secondTarget","__toCommonJS","value","index_exports","ConnectKitButton","import_components","LockContract","import_examples","NetworkSwitcher","TransactionStatusComponent","TransactionStatus","WalletAvatar","WalletButton","WalletProvider","import_providers","WalletStatus","arbitrum","import_chains","base","defaultChains","lockAbi","mainnet","optimism","polygon","sepolia","useAccount","import_hooks","useBalance","useBlockNumber"],"sources":["../../src/index.ts"],"sourcesContent":[null],"mappings":"AACA;;AAAA,IACEA,SAAA,GAAAC,MAAA,CAAAC,cAAA;AAAA,IACAC,gBAAA,GAAAF,MAAA,CAAAG,wBAAA;AAAA,IACAC,iBAAA,GAAAJ,MAAA,CAAAK,mBAAA;AAAA,IACAC,YAAA,GAAAN,MAAA,CAAAO,SAAA,CAAAC,cAAA;AAAA,IAAAC,QAIK,GAAAA,CAAAC,MAAA,EAAAC,GAAA;EAGP,SAAAC,IAAA,IAAAD,GAAA,EACEZ,SAAA,CAAAW,MAAA,EAAAE,IAAA;IAAAC,GAAA,EAAAF,GAAA,CAAAC,IAAA;IAAAE,UAAA;EAAA;AAAA;AAKA,IACAC,WAAA,GAAAA,CAAAC,EAAA,EAAAC,IAAA,EAAAC,MAAA,EAAAC,IAAA;EAOA,IAAAF,IAAA,WAAAA,IAAA,wBAAAA,IAAA;IACA,SAAAG,GAAA,IAAAhB,iBAAA,CAAAa,IAAA,GACA,KAAAX,YAAA,CAAAe,IAAA,CAAAL,EAAA,EAAAI,GAAA,KAAAA,GAAA,KAAAF,MAAA,EACAnB,SAAA,CAAAiB,EAAA,EAAAI,GAAA;MAAAP,GAAA,EAAAA,CAAA,KAAAI,IAAA,CAAAG,GAAA;MAAAN,UAAA,IAAAK,IAAA,GAAAjB,gBAAA,CAAAe,IAAA,EAAAG,GAAA,MAAAD,IAAA,CAAAL;IAAA;EACA;EACA,OAAAE,EAAA;AAAA;AACA,IACAM,UAAA,GAAAA,CAAAZ,MAAA,EAAAa,GAAA,EAAAC,YAAA,MAAAT,WAAA,CAAAL,MAAA,EAAAa,GAAA,cAAAC,YAAA,IAAAT,WAAA,CAAAS,YAAA,EAAAD,GAAA;AAAA,IACAE,YAAA,GAAAF,GAAA,IAAAR,WAAA,CAAAhB,SAAA;EAAA2B,KAAA;AAAA,IAAAH,GAAA;AAAA,IACAI,aAAA;AAAAlB,QACA,CAAAkB,aAAA;EACAC,gBAAA,EAAAA,CAAA,KAAAC,iBAAA,CAAAD,gBAAA;EACAE,YAAA,EAAAA,CAAA,KAAAC,eAAA,CAAAD,YAAA;EACAE,eAAA,EAAAA,CAAA,KAAAH,iBAAA,CAAAG,eAAA;EACAC,0BAAA,EAAAA,CAAA,KAAAJ,iBAAA,CAAAK,iBAAA;EAAAC,YACK,EAAAA,CAAA,KAAAN,iBAAA,CAAAM,YAAA;EAGPC,YAAA,EAAAA,CAAA,KAAAP,iBAAA,CAAAO,YAAA;EACEC,cAAA,EAAAA,CAAA,KAAAC,gBAAA,CAAAD,cAAA;EACAE,YAAA,EAAAA,CAAA,KAAAV,iBAAA,CAAAU,YAAA;EACAC,QAAA,EAAAA,CAAA,KAAAC,aAAA,CAAAD,QAAA;EACAE,IAAA,EAAAA,CAAA,KAAAD,aAAA,CAAAC,IAAA;EACqBC,aAAA,EAAAA,CAAA,KAAAL,gBAAA,CAAAK,aAAA;EACrBC,OAAA,EAAAA,CAAA,KAAAb,eAAA,CAAAa,OAAA;EAAAC,OAMK,EAAAA,CAAA,KAAAJ,aAAA,CAAAI,OAAA;EAGPC,QAAS,EAAAA,CAAA,KAAAL,aAAc,CAAAK,QAAuC;EAI9DC,OAAS,EAAAA,CAAA,KAAAN,aAAkB,CAAAM,OAAU;EAGrCC,OAAA,EAAAA,CAAA,KAAcP,aAAA,CAAAO,OAAA;EAGdC,UAAA,EAAcA,CAAA,KAAAC,YAAA,CAAAD,UAAA;EAIdE,UAAA,EAAcA,CAAA,KAAAD,YAAA,CAAAC,UAAA;EASdC,cAAc,EAAAA,CAAA,KAAAF,YAAA,CAAAE,cAAA","ignoreList":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@multiplatform.one/web3",
-  "version": "7.25.0",
+  "version": "7.26.0",
   "description": "Web3 wallet integration for multiplatform.one ecosystem with ConnectKit and wagmi",
   "keywords": [
     "connectkit",
@@ -107,10 +107,10 @@
   "dependencies": {
     "@aave/account": "^0.2.0",
     "@metamask/connect-evm": "^2.1.1",
-    "@multiplatform.one/connectkit": "7.25.0",
-    "@multiplatform.one/gpg": "7.25.0",
-    "@multiplatform.one/platform": "7.25.0",
-    "@multiplatform.one/theme": "7.25.0",
+    "@multiplatform.one/connectkit": "7.26.0",
+    "@multiplatform.one/gpg": "7.26.0",
+    "@multiplatform.one/platform": "7.26.0",
+    "@multiplatform.one/theme": "7.26.0",
     "@noble/curves": "^1.9.7",
     "@solana/kit": "^8.3.0",
     "@solana/wallet-adapter-base": "^0.9.27",
@@ -134,7 +134,7 @@
     "wagmi": "^3.7.1"
   },
   "devDependencies": {
-    "@multiplatform.one/config": "7.25.0",
+    "@multiplatform.one/config": "7.26.0",
     "@tamagui/build": "2.7.6",
     "@tanstack/react-query": "^5.100.7",
     "@testing-library/jest-dom": "^6.9.1",

package/src/core/family.spec.ts

@@ -0,0 +1,117 @@
+import { describe, expect, it } from "vitest";
+import { testDriver } from "../../tests/core/testDriver";
+import { createFamilyRegistry, defineWalletFamily, type WalletFamilyDefinition } from "./family";
+
+const message = {
+  header: "wants you to sign in with your Solana account:",
+  statement: null,
+  chainId: "solana:mainnet",
+};
+const driver = () => testDriver("solana", [], {});
+const sol: WalletFamilyDefinition = {
+  id: "sol",
+  label: "Solana",
+  aliases: ["solana"],
+  message,
+  driver,
+};
+const gpg: WalletFamilyDefinition = {
+  id: "gpg",
+  label: "GPG",
+  message: {
+    header: "wants you to sign in with your GPG key.",
+    statement: null,
+    chainId: null,
+    address: false,
+  },
+  connectionless: true,
+};
+
+describe("defineWalletFamily", () => {
+  it("returns a frozen family with defaults filled in", () => {
+    const family = defineWalletFamily({ id: "sui", label: "Sui", message, driver });
+    expect(family).toMatchObject({ id: "sui", label: "Sui", aliases: [], connectionless: false });
+    expect(Object.isFrozen(family)).toBe(true);
+    expect(Object.isFrozen(family.aliases)).toBe(true);
+    expect(Object.isFrozen(family.message)).toBe(true);
+  });
+
+  it("does not share the caller's arrays", () => {
+    const aliases = ["solana"];
+    const family = defineWalletFamily({ ...sol, aliases });
+    aliases.push("other");
+    expect(family.aliases).toEqual(["solana"]);
+  });
+
+  it("a connectionless family has no driver", () => {
+    expect(defineWalletFamily(gpg).connectionless).toBe(true);
+    expect(() => defineWalletFamily({ ...gpg, driver })).toThrow(
+      /connectionless.*cannot have a driver/,
+    );
+  });
+
+  it("a connectable family needs a driver", () => {
+    expect(() => defineWalletFamily({ ...sol, driver: undefined })).toThrow(/needs a driver/);
+  });
+
+  it.each([
+    [{ id: "Sol" }, /id must be lowercase/],
+    [{ id: "" }, /id must be lowercase/],
+    [{ id: "9sol" }, /id must be lowercase/],
+    [{ aliases: ["Solana"] }, /alias must be lowercase/],
+    [{ aliases: ["sol"] }, /its own id as an alias/],
+    [{ label: " " }, /needs a label/],
+    [{ message: { ...message, header: "" } }, /message spec with a header/],
+  ])("refuses %o", (change, error) => {
+    expect(() => defineWalletFamily({ ...sol, ...change } as WalletFamilyDefinition)).toThrow(
+      error,
+    );
+  });
+});
+
+describe("createFamilyRegistry", () => {
+  const registry = createFamilyRegistry([defineWalletFamily(sol), defineWalletFamily(gpg)]);
+
+  it("finds a family by id or alias, in the order the app listed them", () => {
+    expect(registry.families.map((family) => family.id)).toEqual(["sol", "gpg"]);
+    expect(registry.get("sol")?.label).toBe("Solana");
+    expect(registry.get("solana")?.id).toBe("sol");
+    expect(registry.get("eth")).toBeUndefined();
+  });
+
+  it("require names the registered families when one is missing", () => {
+    expect(registry.require("solana").id).toBe("sol");
+    expect(() => registry.require("eth")).toThrow(
+      "wallet family eth is not registered; registered: sol, gpg",
+    );
+    expect(() => createFamilyRegistry([]).require("eth")).toThrow(/registered: none/);
+  });
+
+  it("carries each family's message spec", () => {
+    expect(registry.messages.families).toEqual(["sol", "gpg"]);
+    expect(registry.messages.resolve("solana")).toBe("sol");
+    expect(registry.messages.spec("gpg")?.address).toBe(false);
+  });
+
+  it("refuses a family registered twice and a name two families claim", () => {
+    expect(() => createFamilyRegistry([defineWalletFamily(sol), defineWalletFamily(sol)])).toThrow(
+      /sol is registered twice/,
+    );
+    expect(() =>
+      createFamilyRegistry([
+        defineWalletFamily(sol),
+        defineWalletFamily({ ...gpg, aliases: ["solana"] }),
+      ]),
+    ).toThrow(/"solana" is claimed by sol and gpg/);
+    expect(() =>
+      createFamilyRegistry([
+        defineWalletFamily({ ...gpg, aliases: ["sol"] }),
+        defineWalletFamily(sol),
+      ]),
+    ).toThrow(/"sol" is claimed by gpg and sol/);
+  });
+
+  it("the registry's family list cannot be changed", () => {
+    expect(Object.isFrozen(registry.families)).toBe(true);
+  });
+});

package/src/core/family.ts

@@ -0,0 +1,103 @@
+import type { ScreenDef } from "@multiplatform.one/connectkit";
+import type { ComponentType, ReactNode } from "react";
+import {
+  createMessageRegistry,
+  type WalletMessageRegistry,
+  type WalletMessageSpec,
+} from "./message";
+import { assertName, nameTable } from "./names";
+import type { ConnectionDriver } from "./types";
+
+/** What a family package hands the core: `eth({chains})`, `sol({rpcUrl})`, `gpg()`. */
+export interface WalletFamilyDefinition {
+  /** Short family id, the one the Keycloak message names: `eth`, `sol`, `sui`, `btc`, `gpg`. */
+  readonly id: string;
+  readonly label: string;
+  /** Other names callers use for the family, such as the ecosystem name `evm` for `eth`. */
+  readonly aliases?: readonly string[];
+  readonly message: WalletMessageSpec;
+  /**
+   * Makes the family's connection driver. The store calls it once, the first
+   * time it needs the family, so a family nobody touches starts nothing.
+   */
+  readonly driver?: () => ConnectionDriver;
+  /** Signs without a wallet connection (GPG). Such a family has no driver. */
+  readonly connectionless?: boolean;
+  /** Modal screens the family contributes. */
+  readonly screens?: readonly ScreenDef[];
+  /** A provider the family needs mounted around the app. */
+  readonly Provider?: ComponentType<{ children?: ReactNode }>;
+}
+
+export interface WalletFamily extends WalletFamilyDefinition {
+  readonly aliases: readonly string[];
+  readonly connectionless: boolean;
+}
+
+/** Validates a family definition and freezes it. */
+export function defineWalletFamily(definition: WalletFamilyDefinition): WalletFamily {
+  assertName("wallet family id", definition.id);
+  const aliases = [...(definition.aliases ?? [])];
+  for (const alias of aliases) {
+    assertName(`wallet family ${definition.id} alias`, alias);
+    if (alias === definition.id) {
+      throw new Error(`wallet family ${definition.id} lists its own id as an alias`);
+    }
+  }
+  if (typeof definition.label !== "string" || !definition.label.trim()) {
+    throw new Error(`wallet family ${definition.id} needs a label`);
+  }
+  const { message } = definition;
+  if (!message || typeof message.header !== "string" || !message.header) {
+    throw new Error(`wallet family ${definition.id} needs a message spec with a header`);
+  }
+  const connectionless = definition.connectionless === true;
+  if (connectionless && definition.driver) {
+    throw new Error(`wallet family ${definition.id} is connectionless and cannot have a driver`);
+  }
+  if (!connectionless && typeof definition.driver !== "function") {
+    throw new Error(`wallet family ${definition.id} needs a driver, or connectionless: true`);
+  }
+  return Object.freeze({
+    ...definition,
+    aliases: Object.freeze(aliases),
+    connectionless,
+    message: Object.freeze({ ...message }),
+    ...(definition.screens ? { screens: Object.freeze([...definition.screens]) } : {}),
+  });
+}
+
+export interface FamilyRegistry {
+  /** In the order the app listed them, which is the connect list's order. */
+  readonly families: readonly WalletFamily[];
+  /** The family for an id or alias, or undefined. */
+  get(family: string): WalletFamily | undefined;
+  /** The family for an id or alias. Throws naming the registered families. */
+  require(family: string): WalletFamily;
+  readonly messages: WalletMessageRegistry;
+}
+
+/** The families one app registered. Refuses a family, id or alias registered twice. */
+export function createFamilyRegistry(families: readonly WalletFamily[]): FamilyRegistry {
+  const list = Object.freeze([...families]);
+  const names = nameTable(list);
+  const byId = new Map(list.map((family) => [family.id, family]));
+  const get = (family: string) => {
+    const id = names.get(family);
+    return id === undefined ? undefined : byId.get(id);
+  };
+  return {
+    families: list,
+    get,
+    require(family) {
+      const found = get(family);
+      if (found === undefined) {
+        throw new Error(
+          `wallet family ${family} is not registered; registered: ${list.map((entry) => entry.id).join(", ") || "none"}`,
+        );
+      }
+      return found;
+    },
+    messages: createMessageRegistry(list),
+  };
+}

package/src/core/imports.spec.ts

@@ -0,0 +1,82 @@
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join, relative } from "node:path";
+import { fileURLToPath } from "node:url";
+import ts from "typescript";
+import { describe, expect, it } from "vitest";
+
+const src = fileURLToPath(new URL("..", import.meta.url));
+const entry = fileURLToPath(new URL("./index.ts", import.meta.url));
+
+function resolveRelative(from: string, specifier: string): string {
+  const base = join(dirname(from), specifier);
+  for (const candidate of [
+    `${base}.ts`,
+    `${base}.tsx`,
+    join(base, "index.ts"),
+    join(base, "index.tsx"),
+  ]) {
+    if (existsSync(candidate)) return candidate;
+  }
+  throw new Error(`cannot resolve ${specifier} from ${from}`);
+}
+
+/** Specifiers a file loads at runtime: type-only imports and exports are erased. */
+function runtimeSpecifiers(file: string): string[] {
+  const source = ts.createSourceFile(
+    file,
+    readFileSync(file, "utf8"),
+    ts.ScriptTarget.Latest,
+    true,
+  );
+  const found: string[] = [];
+  const visit = (node: ts.Node) => {
+    if (ts.isImportDeclaration(node) && !node.importClause?.isTypeOnly) {
+      found.push((node.moduleSpecifier as ts.StringLiteral).text);
+    } else if (ts.isExportDeclaration(node) && node.moduleSpecifier && !node.isTypeOnly) {
+      found.push((node.moduleSpecifier as ts.StringLiteral).text);
+    } else if (
+      ts.isCallExpression(node) &&
+      (node.expression.kind === ts.SyntaxKind.ImportKeyword ||
+        (ts.isIdentifier(node.expression) && node.expression.text === "require")) &&
+      node.arguments[0] &&
+      ts.isStringLiteral(node.arguments[0])
+    ) {
+      found.push(node.arguments[0].text);
+    }
+    ts.forEachChild(node, visit);
+  };
+  visit(source);
+  return found;
+}
+
+function runtimeGraph(start: string) {
+  const files = new Set<string>();
+  const packages = new Map<string, string>();
+  const walk = (file: string) => {
+    if (files.has(file)) return;
+    files.add(file);
+    for (const specifier of runtimeSpecifiers(file)) {
+      if (specifier.startsWith(".")) walk(resolveRelative(file, specifier));
+      else packages.set(specifier, relative(src, file));
+    }
+  };
+  walk(start);
+  return { files: [...files].map((file) => relative(src, file)).sort(), packages };
+}
+
+describe("the core entry", () => {
+  it("loads no chain SDK: only React and its own files", () => {
+    const { files, packages } = runtimeGraph(entry);
+    expect(Object.fromEntries(packages)).toEqual({ react: "core/react.ts" });
+    expect(files.every((file) => file.startsWith("core/") || file === "clients/types.ts")).toBe(
+      true,
+    );
+  });
+
+  it("the scan sees a runtime import it should refuse", () => {
+    const { packages } = runtimeGraph(
+      fileURLToPath(new URL("../message/index.ts", import.meta.url)),
+    );
+    expect(packages.has("viem")).toBe(true);
+  });
+});

package/src/core/index.ts

@@ -0,0 +1,47 @@
+// Core contracts of mpo web3 (MPO-385): the family registry, the connection
+// driver interface, the connection store and the message registry. Nothing here
+// imports a chain SDK; each family package brings its own driver and message.
+export {
+  createFamilyRegistry,
+  defineWalletFamily,
+  type FamilyRegistry,
+  type WalletFamily,
+  type WalletFamilyDefinition,
+} from "./family";
+export {
+  createMessageRegistry,
+  formatWalletMessage,
+  type MessageFamily,
+  type WalletMessageRegistry,
+  type WalletMessageSpec,
+} from "./message";
+export {
+  createConnectionStore,
+  defaultConnectionStorageKey,
+  type ConnectionStore,
+  type ConnectionStoreOptions,
+  type FamilyConnector,
+} from "./store";
+export {
+  ConnectionProvider,
+  useConnection,
+  useConnectionStore,
+  type ConnectionProviderProps,
+} from "./react";
+export type {
+  ConnectionDriver,
+  ConnectionState,
+  ConnectionStatus,
+  ConnectionStorage,
+  DriverAccount,
+  DriverConnectOptions,
+  DriverState,
+  SavedConnection,
+  WalletConnector,
+} from "./types";
+export {
+  UnsupportedClientMethodError,
+  type ChainClient,
+  type ClientCapability,
+  type ClientFamily,
+} from "../clients/types";

package/src/core/message.spec.ts

@@ -0,0 +1,178 @@
+import { getAddress } from "viem";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { buildWalletMessage, type SignerFamily } from "../message/buildWalletMessage";
+import { createMessageRegistry, formatWalletMessage, type MessageFamily } from "./message";
+
+// The five families as their packages will register them. Kept in step with
+// buildWalletMessage, which every Keycloak golden test already pins.
+const families: MessageFamily[] = [
+  {
+    id: "eth",
+    aliases: ["evm"],
+    message: {
+      header: "wants you to sign in with your Ethereum account:",
+      statement: "Sign in With Ethereum.",
+      chainId: "1",
+      numericChainId: true,
+      keepStatementLine: true,
+      normalizeAddress: (address) => getAddress(address),
+    },
+  },
+  {
+    id: "sol",
+    aliases: ["solana"],
+    message: {
+      header: "wants you to sign in with your Solana account:",
+      statement: "Sign in With Solana.",
+      chainId: "solana:mainnet",
+    },
+  },
+  {
+    id: "sui",
+    message: {
+      header: "wants you to sign in with your Sui account:",
+      statement: "Sign in With Sui.",
+      chainId: "sui:mainnet",
+    },
+  },
+  {
+    id: "btc",
+    aliases: ["bitcoin"],
+    message: {
+      header: "wants you to sign in with your Bitcoin account:",
+      statement: "Sign in With Bitcoin.",
+      chainId: "bitcoin",
+    },
+  },
+  {
+    id: "gpg",
+    message: {
+      header: "wants you to sign in with your GPG key.",
+      statement: null,
+      chainId: null,
+      address: false,
+    },
+  },
+];
+
+const registry = createMessageRegistry(families);
+const names: SignerFamily[] = ["eth", "evm", "sol", "solana", "sui", "btc", "bitcoin", "gpg"];
+const base = {
+  domain: "app.multiplatform.one",
+  uri: "https://app.multiplatform.one/login",
+  nonce: "ohY7vD2Kq9",
+  issuedAt: "2026-09-26T20:48:18.648Z",
+  address: "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
+};
+
+const outcome = (build: () => string) => {
+  try {
+    return { message: build() };
+  } catch {
+    return { threw: true };
+  }
+};
+
+afterEach(() => {
+  vi.unstubAllGlobals();
+});
+
+describe("the core message registry", () => {
+  it("builds the same bytes as buildWalletMessage for every family, alias and option", () => {
+    let compared = 0;
+    for (const family of names) {
+      for (const statement of [undefined, null, "", "Custom statement."]) {
+        for (const chainId of [undefined, 137, "solana:devnet", 900001]) {
+          for (const version of [undefined, "2"]) {
+            const opts = { ...base, statement, chainId, version };
+            expect(registry.build(family, opts), `${family} ${JSON.stringify(opts)}`).toBe(
+              buildWalletMessage(family, opts),
+            );
+            compared++;
+          }
+        }
+      }
+    }
+    expect(compared).toBe(256);
+  });
+
+  it("refuses what buildWalletMessage refuses", () => {
+    for (const family of names) {
+      for (const opts of [
+        { ...base, address: undefined },
+        { ...base, domain: "evil.example\nURI: https://evil.example" },
+        { ...base, uri: "https://a\nb" },
+        { ...base, statement: "two\nlines" },
+      ]) {
+        expect(outcome(() => registry.build(family, opts))).toEqual(
+          outcome(() => buildWalletMessage(family, opts)),
+        );
+      }
+    }
+  });
+
+  it("takes domain and uri from the page like buildWalletMessage", () => {
+    for (const location of [
+      { host: "shop.example", origin: "https://shop.example" },
+      { host: "file.example", origin: "null" },
+      { host: "", origin: "" },
+    ]) {
+      vi.stubGlobal("location", location);
+      for (const family of names) {
+        const opts = { nonce: base.nonce, issuedAt: base.issuedAt, address: base.address };
+        expect(outcome(() => registry.build(family, opts))).toEqual(
+          outcome(() => buildWalletMessage(family, opts)),
+        );
+      }
+    }
+  });
+
+  it("resolves aliases and lists families in registration order", () => {
+    expect(registry.families).toEqual(["eth", "sol", "sui", "btc", "gpg"]);
+    expect(registry.resolve("evm")).toBe("eth");
+    expect(registry.resolve("cosmos")).toBeUndefined();
+    expect(registry.spec("bitcoin")?.chainId).toBe("bitcoin");
+  });
+
+  it("names the registered families when asked for another", () => {
+    expect(() => registry.build("cosmos", base)).toThrow(
+      "no wallet message for family cosmos; registered: eth, sol, sui, btc, gpg",
+    );
+    expect(() => createMessageRegistry([]).build("eth", base)).toThrow(/registered: none/);
+  });
+
+  it("a new family needs only a spec", () => {
+    const cosmos = createMessageRegistry([
+      {
+        id: "cosmos",
+        message: {
+          header: "wants you to sign in with your Cosmos account:",
+          statement: "Sign in With Cosmos.",
+          chainId: "cosmoshub-4",
+        },
+      },
+    ]);
+    expect(cosmos.build("cosmos", { ...base, address: "cosmos1abc" }).split("\n")).toEqual([
+      "app.multiplatform.one wants you to sign in with your Cosmos account:",
+      "cosmos1abc",
+      "",
+      "Sign in With Cosmos.",
+      "",
+      "URI: https://app.multiplatform.one/login",
+      "Version: 1",
+      "Chain ID: cosmoshub-4",
+      "Nonce: ohY7vD2Kq9",
+      "Issued At: 2026-09-26T20:48:18.648Z",
+    ]);
+  });
+
+  it("formatWalletMessage names the family in its errors", () => {
+    expect(() =>
+      formatWalletMessage(
+        { header: "wants you to sign in:", statement: null, chainId: null },
+        { ...base, address: undefined },
+        "sol",
+      ),
+    ).toThrow("wallet message: sol needs an address");
+  });
+});