@awarizon/web3 1.0.2 → 1.1.1

package/dist/index.js

@@ -361,6 +361,36 @@ var TelemetryClient = class {
     );
   }
 };
+var ERC20_ABI = viem.erc20Abi;
+var ERC721_ABI = [
+  { type: "function", name: "name", stateMutability: "view", inputs: [], outputs: [{ type: "string" }] },
+  { type: "function", name: "symbol", stateMutability: "view", inputs: [], outputs: [{ type: "string" }] },
+  { type: "function", name: "tokenURI", stateMutability: "view", inputs: [{ name: "tokenId", type: "uint256" }], outputs: [{ type: "string" }] },
+  { type: "function", name: "totalSupply", stateMutability: "view", inputs: [], outputs: [{ type: "uint256" }] },
+  { type: "function", name: "ownerOf", stateMutability: "view", inputs: [{ name: "tokenId", type: "uint256" }], outputs: [{ type: "address" }] },
+  { type: "function", name: "balanceOf", stateMutability: "view", inputs: [{ name: "owner", type: "address" }], outputs: [{ type: "uint256" }] },
+  { type: "function", name: "getApproved", stateMutability: "view", inputs: [{ name: "tokenId", type: "uint256" }], outputs: [{ type: "address" }] },
+  { type: "function", name: "isApprovedForAll", stateMutability: "view", inputs: [{ name: "owner", type: "address" }, { name: "operator", type: "address" }], outputs: [{ type: "bool" }] },
+  { type: "function", name: "transferFrom", stateMutability: "nonpayable", inputs: [{ name: "from", type: "address" }, { name: "to", type: "address" }, { name: "tokenId", type: "uint256" }], outputs: [] },
+  { type: "function", name: "safeTransferFrom", stateMutability: "nonpayable", inputs: [{ name: "from", type: "address" }, { name: "to", type: "address" }, { name: "tokenId", type: "uint256" }], outputs: [] },
+  { type: "function", name: "approve", stateMutability: "nonpayable", inputs: [{ name: "to", type: "address" }, { name: "tokenId", type: "uint256" }], outputs: [] },
+  { type: "function", name: "setApprovalForAll", stateMutability: "nonpayable", inputs: [{ name: "operator", type: "address" }, { name: "approved", type: "bool" }], outputs: [] },
+  { type: "event", name: "Transfer", inputs: [{ indexed: true, name: "from", type: "address" }, { indexed: true, name: "to", type: "address" }, { indexed: true, name: "tokenId", type: "uint256" }] },
+  { type: "event", name: "Approval", inputs: [{ indexed: true, name: "owner", type: "address" }, { indexed: true, name: "approved", type: "address" }, { indexed: true, name: "tokenId", type: "uint256" }] },
+  { type: "event", name: "ApprovalForAll", inputs: [{ indexed: true, name: "owner", type: "address" }, { indexed: true, name: "operator", type: "address" }, { name: "approved", type: "bool" }] }
+];
+var ERC1155_ABI = [
+  { type: "function", name: "uri", stateMutability: "view", inputs: [{ name: "id", type: "uint256" }], outputs: [{ type: "string" }] },
+  { type: "function", name: "balanceOf", stateMutability: "view", inputs: [{ name: "account", type: "address" }, { name: "id", type: "uint256" }], outputs: [{ type: "uint256" }] },
+  { type: "function", name: "balanceOfBatch", stateMutability: "view", inputs: [{ name: "accounts", type: "address[]" }, { name: "ids", type: "uint256[]" }], outputs: [{ type: "uint256[]" }] },
+  { type: "function", name: "isApprovedForAll", stateMutability: "view", inputs: [{ name: "account", type: "address" }, { name: "operator", type: "address" }], outputs: [{ type: "bool" }] },
+  { type: "function", name: "setApprovalForAll", stateMutability: "nonpayable", inputs: [{ name: "operator", type: "address" }, { name: "approved", type: "bool" }], outputs: [] },
+  { type: "function", name: "safeTransferFrom", stateMutability: "nonpayable", inputs: [{ name: "from", type: "address" }, { name: "to", type: "address" }, { name: "id", type: "uint256" }, { name: "amount", type: "uint256" }, { name: "data", type: "bytes" }], outputs: [] },
+  { type: "function", name: "safeBatchTransferFrom", stateMutability: "nonpayable", inputs: [{ name: "from", type: "address" }, { name: "to", type: "address" }, { name: "ids", type: "uint256[]" }, { name: "amounts", type: "uint256[]" }, { name: "data", type: "bytes" }], outputs: [] },
+  { type: "event", name: "TransferSingle", inputs: [{ indexed: true, name: "operator", type: "address" }, { indexed: true, name: "from", type: "address" }, { indexed: true, name: "to", type: "address" }, { name: "id", type: "uint256" }, { name: "value", type: "uint256" }] },
+  { type: "event", name: "TransferBatch", inputs: [{ indexed: true, name: "operator", type: "address" }, { indexed: true, name: "from", type: "address" }, { indexed: true, name: "to", type: "address" }, { name: "ids", type: "uint256[]" }, { name: "values", type: "uint256[]" }] },
+  { type: "event", name: "ApprovalForAll", inputs: [{ indexed: true, name: "account", type: "address" }, { indexed: true, name: "operator", type: "address" }, { name: "approved", type: "bool" }] }
+];
 var WalletProxy = class {
   constructor(engine, ensureReady) {
     this.engine = engine;
@@ -398,8 +428,11 @@ var WalletProxy = class {
   hasInternalWallet() {
     return this.engine.hasInternalWallet();
   }
-  connectExternal(c) {
-    this.engine.connectExternal(c);
+  getConnectorInfo() {
+    return this.engine.getConnectorInfo();
+  }
+  connectExternal(c, info) {
+    this.engine.connectExternal(c, info);
   }
   disconnectExternal() {
     this.engine.disconnectExternal();
@@ -410,12 +443,40 @@ var WalletProxy = class {
   async switchChain(chain) {
     return this.engine.switchChain(chain);
   }
+  // ── Gated async — EIP-1193, signing, chain awareness ───────────────────────
+  async connectEIP1193(provider, info) {
+    await this.ensureReady();
+    return this.engine.connectEIP1193(provider, info);
+  }
+  async signMessage(message) {
+    await this.ensureReady();
+    return this.engine.signMessage(message);
+  }
+  async signTypedData(params) {
+    await this.ensureReady();
+    return this.engine.signTypedData(params);
+  }
+  async getChainId() {
+    return this.engine.getChainId();
+  }
+  async isChainMismatch() {
+    return this.engine.isChainMismatch();
+  }
+  // ── Event subscriptions ────────────────────────────────────────────────────
+  onWalletChange(cb) {
+    return this.engine.onWalletChange(cb);
+  }
+  onChainChange(cb) {
+    return this.engine.onChainChange(cb);
+  }
 };
 var AwarizonWeb3 = class {
   constructor(config) {
     // Contract instances are cached by address — same address returns same instance.
     // Cache is cleared on switchChain() since contracts are chain-specific.
     this._contractCache = /* @__PURE__ */ new Map();
+    // Named contract registry — register once, reference by name anywhere.
+    this._registry = /* @__PURE__ */ new Map();
     if (!config.apiKey) throw new ApiKeyRequiredError();
     this.chain = resolveChain(config.chain);
     this.publicClient = viem.createPublicClient({
@@ -441,8 +502,27 @@ var AwarizonWeb3 = class {
     }
   }
   // ─── Wallet API surface ─────────────────────────────────────────────────────
-  connectWallet(walletClient) {
-    this._engine.connectExternal(walletClient);
+  /**
+   * Connect any viem WalletClient (wagmi, RainbowKit, custom).
+   * Optionally pass connector metadata to display in the UI.
+   *
+   * @example
+   * awarizon.connectWallet(walletClient, { name: "MetaMask" })
+   */
+  connectWallet(walletClient, connectorInfo) {
+    this._engine.connectExternal(walletClient, connectorInfo);
+    return this;
+  }
+  /**
+   * Connect directly from a raw EIP-1193 provider without needing wagmi.
+   * Works with window.ethereum, WalletConnect v2, and any EIP-1193 object.
+   *
+   * @example
+   * await awarizon.connectEIP1193Provider(window.ethereum, { name: "MetaMask" })
+   */
+  async connectEIP1193Provider(provider, connectorInfo) {
+    await this._telemetry.ensureValidated();
+    await this._engine.connectEIP1193(provider, connectorInfo);
     return this;
   }
   disconnectWallet() {
@@ -457,12 +537,86 @@ var AwarizonWeb3 = class {
     return this;
   }
   getWalletInfo() {
+    const info = this._engine.getConnectorInfo();
     return {
       address: this._engine.address(),
       chain: this.chain,
-      isExternal: this._engine.hasExternalWallet()
+      isExternal: this._engine.hasExternalWallet(),
+      connectorName: info.name
     };
   }
+  /**
+   * Sign a plain text or raw-bytes message.
+   * Use for Sign-In with Ethereum (SIWE) and off-chain authorization.
+   *
+   * @example
+   * const sig = await awarizon.signMessage("Hello, Awarizon!")
+   */
+  async signMessage(message) {
+    await this._telemetry.ensureValidated();
+    return this._engine.signMessage(message);
+  }
+  /**
+   * Sign EIP-712 typed structured data (permit2, SIWE, Seaport orders, etc.).
+   *
+   * @example
+   * const sig = await awarizon.signTypedData({
+   *   domain: { name: "MyApp", version: "1", chainId: 8453 },
+   *   types:  { Transfer: [{ name: "to", type: "address" }, { name: "amount", type: "uint256" }] },
+   *   primaryType: "Transfer",
+   *   message: { to: "0x...", amount: "1000000" },
+   * })
+   */
+  async signTypedData(params) {
+    await this._telemetry.ensureValidated();
+    return this._engine.signTypedData(params);
+  }
+  /**
+   * Returns the chain ID the active wallet is currently on.
+   * For external wallets this may differ from the SDK's configured chain.
+   */
+  async getChainId() {
+    return this._engine.getChainId();
+  }
+  /**
+   * Returns true when the external wallet is on a different chain than the SDK.
+   * Use this to show a "wrong network" banner in your UI.
+   *
+   * @example
+   * if (await awarizon.isChainMismatch()) {
+   *   alert("Please switch to Base in your wallet")
+   * }
+   */
+  async isChainMismatch() {
+    return this._engine.isChainMismatch();
+  }
+  /**
+   * Returns metadata about the currently active connector.
+   * Useful for displaying "Connected via MetaMask" in the UI.
+   */
+  getConnectorInfo() {
+    return this._engine.getConnectorInfo();
+  }
+  /**
+   * Subscribe to wallet changes (connect, disconnect, account switch).
+   * Returns an unsubscribe function — call it on cleanup.
+   *
+   * @example
+   * const unsub = awarizon.onWalletChange(({ address, type, name }) => {
+   *   console.log("Wallet changed:", address, type, name)
+   * })
+   * unsub() // stop listening
+   */
+  onWalletChange(cb) {
+    return this._engine.onWalletChange(cb);
+  }
+  /**
+   * Subscribe to chain changes (switchChain calls).
+   * Returns an unsubscribe function.
+   */
+  onChainChange(cb) {
+    return this._engine.onChainChange(cb);
+  }
   // ─── Contract API ───────────────────────────────────────────────────────────
   /**
    * Load a deployed contract and return a fully typed, ABI-powered instance.
@@ -638,6 +792,105 @@ var AwarizonWeb3 = class {
       );
     }
   }
+  // ─── ERC Standard Clients ───────────────────────────────────────────────────
+  /**
+   * Load an ERC-20 token with fully typed methods — no ABI import needed.
+   *
+   * ```ts
+   * const token = await awarizon.erc20("0x...")
+   * const balance = await token.balanceOf(userAddress)
+   * const symbol  = await token.symbol()
+   * await token.transfer(recipient, 100n)
+   * ```
+   */
+  async erc20(address) {
+    const instance = await this.contract({ address, abi: ERC20_ABI });
+    return instance;
+  }
+  /**
+   * Load an ERC-721 NFT contract with fully typed methods — no ABI import needed.
+   *
+   * ```ts
+   * const nft   = await awarizon.erc721("0x...")
+   * const owner = await nft.ownerOf(1n)
+   * const uri   = await nft.tokenURI(1n)
+   * await nft.transferFrom(from, to, 1n)
+   * ```
+   */
+  async erc721(address) {
+    const instance = await this.contract({ address, abi: ERC721_ABI });
+    return instance;
+  }
+  /**
+   * Load an ERC-1155 multi-token contract with fully typed methods — no ABI import needed.
+   *
+   * ```ts
+   * const items   = await awarizon.erc1155("0x...")
+   * const balance = await items.balanceOf(userAddress, 42n)
+   * const uri     = await items.uri(42n)
+   * await items.safeTransferFrom(from, to, 42n, 1n, "0x")
+   * ```
+   */
+  async erc1155(address) {
+    const instance = await this.contract({ address, abi: ERC1155_ABI });
+    return instance;
+  }
+  // ─── Named Contract Registry ────────────────────────────────────────────────
+  /**
+   * Register a contract under a human-readable name.
+   * After registering, use `awarizon.use(name)` anywhere instead of repeating
+   * address + ABI every time.
+   *
+   * ```ts
+   * awarizon.register("USDC",  { address: "0x...", abi: erc20Abi })
+   * awarizon.register("Vault", { address: "0x...", abi: vaultAbi })
+   *
+   * const usdc  = await awarizon.use("USDC")
+   * const vault = await awarizon.use("Vault")
+   * ```
+   */
+  register(name, config) {
+    this._registry.set(name, config);
+    return this;
+  }
+  /**
+   * Retrieve a previously registered contract by name.
+   * Throws a descriptive error if the name was never registered.
+   *
+   * ```ts
+   * const usdc = await awarizon.use("USDC")
+   * await usdc.transfer(recipient, 100n)
+   * ```
+   */
+  async use(name) {
+    const config = this._registry.get(name);
+    if (!config) {
+      const registered = [...this._registry.keys()].join(", ") || "none";
+      throw new Error(
+        `[awarizon/web3] Contract "${name}" is not registered.
+Call awarizon.register("${name}", { address, abi }) first.
+Currently registered: ${registered}`
+      );
+    }
+    return this.contract(config);
+  }
+  /**
+   * Remove a registered contract from the registry.
+   *
+   * ```ts
+   * awarizon.unregister("USDC")
+   * ```
+   */
+  unregister(name) {
+    this._registry.delete(name);
+    return this;
+  }
+  /**
+   * Return all registered contract names.
+   */
+  registeredContracts() {
+    return [...this._registry.keys()];
+  }
   // ─── Accessors ──────────────────────────────────────────────────────────────
   get chainId() {
     return this.chain.id;
@@ -654,6 +907,10 @@ var AwarizonWeb3 = class {
   }
 };
 
+Object.defineProperty(exports, "ChainMismatchError", {
+  enumerable: true,
+  get: function () { return walletEngine.ChainMismatchError; }
+});
 Object.defineProperty(exports, "ChainSwitchError", {
   enumerable: true,
   get: function () { return walletEngine.ChainSwitchError; }
@@ -730,6 +987,9 @@ exports.ApiKeyRequiredError = ApiKeyRequiredError;
 exports.AwarizonWeb3 = AwarizonWeb3;
 exports.CHAINS = CHAINS;
 exports.ContractNotLoadedError = ContractNotLoadedError;
+exports.ERC1155_ABI = ERC1155_ABI;
+exports.ERC20_ABI = ERC20_ABI;
+exports.ERC721_ABI = ERC721_ABI;
 exports.InvalidApiKeyError = InvalidApiKeyError;
 exports.NetworkMismatchError = NetworkMismatchError;
 exports.ProviderError = ProviderError;