Merge pull request #187 from hyperweb-io/query-client-for-unisigner

Query client for unisigner

Author: Zetazzz

docs/advanced/network-implementation-guide.md

@@ -456,7 +456,14 @@ The signer interface provides a consistent API across different networks:
 
 ```typescript
 // Universal signer interface
-interface IUniSigner<TAccount, TSignArgs, TBroadcastOpts, TBroadcastResponse> {
+interface IUniSigner<
+  TAccount,
+  TSignArgs,
+  TBroadcastOpts,
+  TBroadcastResponse,
+  TQueryClient extends IQueryClient = IQueryClient
+> {
+  queryClient: TQueryClient;
   // Account management
   getAccounts(): Promise<readonly TAccount[]>;
 
@@ -476,10 +483,10 @@ interface ISigned<TBroadcastOpts, TBroadcastResponse> {
 }
 
 // Network-specific signer implementation
-class NetworkSigner implements IUniSigner<NetworkAccount, NetworkSignArgs, NetworkBroadcastOpts, NetworkBroadcastResponse> {
+class NetworkSigner implements IUniSigner<NetworkAccount, NetworkSignArgs, NetworkBroadcastOpts, NetworkBroadcastResponse, IQueryClient> {
   constructor(
     private wallet: IWallet,
-    private queryClient: IQueryClient,
+    public readonly queryClient: IQueryClient,
     private config: NetworkSignerConfig
   ) {}
 

docs/advanced/signer.md

@@ -161,7 +161,10 @@ export interface IUniSigner<
   TSignArgs = unknown,
   TBroadcastOpts = unknown,
   TBroadcastResponse extends IBroadcastResult<TTxResp> = IBroadcastResult<TTxResp>,
+  TQueryClient extends IQueryClient = IQueryClient,
 > {
+  // Query interface used for chain reads and broadcasting
+  queryClient: TQueryClient;
   // Account management
   getAccounts(): Promise<readonly TAccount[]>;
 

docs/advanced/tutorial.md

@@ -57,7 +57,10 @@ interface IUniSigner<
   TSignArgs = unknown,
   TBroadcastOpts = unknown,
   TBroadcastResponse extends IBroadcastResult<TTxResp> = IBroadcastResult<TTxResp>,
+  TQueryClient extends IQueryClient = IQueryClient,
 > {
+  // Query interface used for chain reads and broadcasting
+  queryClient: TQueryClient;
   // Account management
   getAccounts(): Promise<readonly TAccount[]>;
 

docs/networks/_meta.json

@@ -1,5 +1,6 @@
 {
   "cosmos": "Cosmos",
   "ethereum": "Ethereum",
-  "injective": "Injective"
+  "injective": "Injective",
+  "solana": "Solana"
 }

docs/networks/ethereum/index.mdx

@@ -230,6 +230,75 @@ console.log("Endpoint:", queryClient.endpoint);
 await queryClient.disconnect();
 ```
 
+### Frontend: window.ethereum (Browser Wallet)
+
+Use the injected EIP-1193 provider (e.g., MetaMask) to send ETH and execute contract functions by ABI.
+
+```typescript
+import { SignerFromBrowser } from "@interchainjs/ethereum";
+
+// Initialize with injected provider
+const signer = new SignerFromBrowser(window.ethereum);
+
+// Request accounts (prompts the wallet)
+const [address] = await signer.getAddresses(true);
+console.log("Connected address:", address);
+
+// 1) Send ETH
+const { transactionHash, wait } = await signer.send({
+  to: "0xRecipient...",
+  // value accepts bigint | number | string; converted to 0x hex automatically
+  value: 1000000000000000n // 0.001 ETH
+});
+console.log("ETH tx:", transactionHash);
+const receipt = await wait();
+console.log("ETH receipt:", receipt.status);
+
+// 2) Read contract function (by ABI)
+// Example: ERC20 balanceOf(address)
+const erc20Abi = [
+  {
+    name: "balanceOf",
+    type: "function",
+    inputs: [{ name: "owner", type: "address" }],
+    outputs: [{ name: "balance", type: "uint256" }]
+  }
+];
+const tokenAddress = "0xToken...";
+const balance = await signer.readContract<bigint>({
+  address: tokenAddress,
+  abi: erc20Abi,
+  functionName: "balanceOf",
+  params: [address]
+});
+console.log("Token balance:", balance.toString());
+
+// 3) Write contract function (by ABI)
+// Example: ERC20 transfer(address,uint256) returns (bool)
+const transferAbi = [
+  {
+    name: "transfer",
+    type: "function",
+    inputs: [
+      { name: "to", type: "address" },
+      { name: "amount", type: "uint256" }
+    ],
+    outputs: [{ name: "ok", type: "bool" }]
+  }
+];
+const { transactionHash: txHash2, wait: wait2 } = await signer.writeContract({
+  address: tokenAddress,
+  abi: transferAbi,
+  functionName: "transfer",
+  params: ["0xRecipient...", 1000000000000000000n] // 1 token (18 decimals)
+  // Optional gas options:
+  // gas, gasPrice, maxFeePerGas, maxPriorityFeePerGas, nonce, chainId
+});
+console.log("transfer tx:", txHash2);
+const transferReceipt = await wait2();
+console.log("transfer status:", transferReceipt.status);
+```
+
 ### Using Ethereum Signers
 
 #### Creating Signers
@@ -466,7 +535,7 @@ console.log(toChecksumAddress(lower));
 ### Legacy Support
 
 - **SignerFromPrivateKey**: Original implementation (maintained for backward compatibility)
-- **SignerFromBrowser**: Browser wallet integration (maintained for backward compatibility)
+- **SignerFromBrowser**: Browser wallet integration via `window.ethereum` (EIP-1193)
 
 ## For Developers
 

docs/networks/solana/_meta.json

@@ -0,0 +1,3 @@
+{
+  "index": "Overview"
+}

docs/networks/solana/index.mdx

@@ -0,0 +1 @@
+Solana Chain

docs/packages/types/index.mdx

@@ -55,7 +55,9 @@ interface IUniSigner<
   TSignArgs = unknown,
   TBroadcastOpts = unknown,
   TBroadcastResponse extends IBroadcastResult<TTxResp> = IBroadcastResult<TTxResp>,
+  TQueryClient extends IQueryClient = IQueryClient,
 > {
+  queryClient: TQueryClient;
   getAccounts(): Promise<readonly TAccount[]>;
   signArbitrary(data: Uint8Array, index?: number): Promise<ICryptoBytes>;
   sign(args: TSignArgs): Promise<ISigned<TBroadcastOpts, TBroadcastResponse>>;

networks/cosmos/src/signers/base-signer.ts

@@ -43,6 +43,10 @@ export abstract class BaseCosmosSigner implements ICosmosSigner, ISigningClient
     this.config.queryClient = originalQueryClient;
   }
 
+  get queryClient() {
+    return this.config.queryClient;
+  }
+
   // ICosmosSigner interface methods
   async getAccounts(): Promise<readonly AccountData[]> {
     if (isOfflineAminoSigner(this.auth) || isOfflineDirectSigner(this.auth)) {
@@ -319,7 +323,7 @@ export abstract class BaseCosmosSigner implements ICosmosSigner, ISigningClient
     const tx = Tx.fromPartial({
       body: txBody,
       authInfo: authInfo,
-      signatures: new Uint8Array([0]), // Empty signatures for simulation
+      signatures: [new Uint8Array(0)], // Empty signatures for simulation
     });
 
     // Encode transaction to bytes

networks/cosmos/src/signers/types.ts

@@ -155,7 +155,8 @@ export interface ICosmosSigner extends IUniSigner<
   AccountData, // account type
   CosmosSignArgs, // sign args
   CosmosBroadcastOptions, // broadcast options
-  CosmosBroadcastResponse // broadcast response
+  CosmosBroadcastResponse, // broadcast response
+  ICosmosQueryClient // query client
 > {
   getAddresses(): Promise<string[]>;
   getChainId(): Promise<string>;
@@ -268,4 +269,4 @@ export type TxOptions = {
 // Document types
 export type CosmosDirectDoc = SignDoc;
 export type CosmosAminoDoc = StdSignDoc;
-export type CosmosTx = TxRaw;
+export type CosmosTx = TxRaw;