graz 0.4.1 → 0.4.3

package/dist/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-'use strict';var m=require('fs/promises'),R=require('path'),url=require('url'),cosmos=require('@keplr-wallet/cosmos'),I=require('arg'),cosmosDirectoryClient=require('cosmos-directory-client'),$=require('p-map');function _interopDefault(e){return e&&e.__esModule?e:{default:e}}function _interopNamespace(e){if(e&&e.__esModule)return e;var n=Object.create(null);if(e){Object.keys(e).forEach(function(k){if(k!=='default'){var d=Object.getOwnPropertyDescriptor(e,k);Object.defineProperty(n,k,d.get?d:{enumerable:true,get:function(){return e[k]}});}})}n.default=e;return Object.freeze(n)}var m__namespace=/*#__PURE__*/_interopNamespace(m);var R__namespace=/*#__PURE__*/_interopNamespace(R);var I__default=/*#__PURE__*/_interopDefault(I);var $__default=/*#__PURE__*/_interopDefault($);var N=()=>typeof document>"u"?new URL(`file:${__filename}`).href:document.currentScript&&document.currentScript.src||new URL("main.js",document.baseURI).href,C=N();var L=R.dirname(url.fileURLToPath(C)),M=n=>/^\d+$/.test(n),_=n=>M(n[0])?`_${n}`:n,b=`Usage: graz [options]
+'use strict';var h=require('fs/promises'),F=require('path'),url=require('url'),cosmos=require('@keplr-wallet/cosmos'),V=require('arg'),cosmosDirectoryClient=require('cosmos-directory-client');function _interopDefault(e){return e&&e.__esModule?e:{default:e}}function _interopNamespace(e){if(e&&e.__esModule)return e;var n=Object.create(null);if(e){Object.keys(e).forEach(function(k){if(k!=='default'){var d=Object.getOwnPropertyDescriptor(e,k);Object.defineProperty(n,k,d.get?d:{enumerable:true,get:function(){return e[k]}});}})}n.default=e;return Object.freeze(n)}var h__namespace=/*#__PURE__*/_interopNamespace(h);var F__namespace=/*#__PURE__*/_interopNamespace(F);var V__default=/*#__PURE__*/_interopDefault(V);var z=()=>typeof document>"u"?new URL(`file:${__filename}`).href:document.currentScript&&document.currentScript.tagName.toUpperCase()==="SCRIPT"?document.currentScript.src:new URL("main.js",document.baseURI).href,A=z();async function R(t,o,{concurrency:i=Number.POSITIVE_INFINITY,stopOnError:d=true,signal:c}={}){return new Promise((l,e)=>{if(t[Symbol.iterator]===void 0&&t[Symbol.asyncIterator]===void 0)throw new TypeError(`Expected \`input\` to be either an \`Iterable\` or \`AsyncIterable\`, got (${typeof t})`);if(typeof o!="function")throw new TypeError("Mapper function is required");if(!(Number.isSafeInteger(i)&&i>=1||i===Number.POSITIVE_INFINITY))throw new TypeError(`Expected \`concurrency\` to be an integer from 1 and up or \`Infinity\`, got \`${i}\` (${typeof i})`);let r=[],m=[],_=new Map,I=false,n=false,N=false,s=0,P=0,G=t[Symbol.iterator]===void 0?t[Symbol.asyncIterator]():t[Symbol.iterator](),x=()=>{g(c.reason);},$=()=>{c?.removeEventListener("abort",x);},v=f=>{l(f),$();},g=f=>{I=true,n=true,e(f),$();};c&&(c.aborted&&g(c.reason),c.addEventListener("abort",x,{once:true}));let C=async()=>{if(n)return;let f=await G.next(),S=P;if(P++,f.done){if(N=true,s===0&&!n){if(!d&&m.length>0){g(new AggregateError(m));return}if(n=true,_.size===0){v(r);return}let p=[];for(let[u,O]of r.entries())_.get(u)!==j&&p.push(O);v(p);}return}s++,(async()=>{try{let p=await f.value;if(n)return;let u=await o(p,S);u===j&&_.set(S,u),r[S]=u,s--,await C();}catch(p){if(d)g(p);else {m.push(p),s--;try{await C();}catch(u){g(u);}}}})();};(async()=>{for(let f=0;f<i;f++){try{await C();}catch(S){g(S);break}if(N||I)break}})();})}var j=Symbol("skip");var q=F.dirname(url.fileURLToPath(A)),X=t=>/^\d+$/.test(t),w=t=>X(t[0])?`_${t}`:t,D=`Usage: graz [options]
 
 Options:
 
@@ -14,7 +14,7 @@ Generate options:
   --authz               Generate only authz compatible chains
 
 https://github.com/graz-sh/graz
-`,r=I__default.default({"--generate":Boolean,"-g":"--generate","--authz":Boolean,"--best":Boolean,"--mainnet":String,"--testnet":String,"-b":"--best","-M":"--mainnet","-T":"--testnet","--help":Boolean,"-h":"--help","--endpoint":String,"-e":"--endpoint"}),v=async()=>{if(r["--help"]){console.log(b);return}if(r["--generate"]){await x();return}console.log(b);},x=async()=>{console.log("\u23F3	Generating chain list..."),r["--authz"]&&console.log("\u270D\uFE0F	Detected authz flag, generating only compatible chains..."),r["--best"]&&console.log("\u{1F481}\u200D\u2642\uFE0F	Detected best flag, setting REST and RPC endpoints to best latency..."),(r["--mainnet"]||r["--testnet"])&&console.log("\u{1F419}	Detected chain filtering flag, generating only given chain paths...");let n,s;if(r["--endpoint"]){console.log("\u{1F310}	Fetching chain information from specified endpoint");try{let e=await fetch(r["--endpoint"]);if(!e.ok)throw new Error(`HTTP error! status: ${e.status}`);let o=await e.json();n=A(o.mainnet,r["--mainnet"]),s=A(o.testnet,r["--testnet"]);}catch(e){console.error(`\u274C	Failed to fetch chain information: ${e.message}`),process.exit(1);}}else [n,s]=await Promise.all([S(cosmosDirectoryClient.createClient(),{filter:r["--mainnet"]}),S(cosmosDirectoryClient.createTestnetClient(),{filter:r["--testnet"]})]);let[a,d]=await Promise.all([m__namespace.readFile(u("index.js.stub"),{encoding:"utf-8"}),m__namespace.readFile(u("index.mjs.stub"),{encoding:"utf-8"})]),f=a.replace("/* REPLACE_MAINNET_DEFS */",h(n)).replace("/* REPLACE_TESTNET_DEFS */",h(s,{testnet:true})).replace("/* REPLACE_MAINNET_CHAINS */",g(n)).replace("/* REPLACE_TESTNET_CHAINS */",g(s,{testnet:true})).replace("/* REPLACE_MAINNET_CHAINS_ARRAY */",p(n)).replace("/* REPLACE_TESTNET_CHAINS_ARRAY */",p(s,{testnet:true})).replace("/* REPLACE_MAINNET_EXPORTS */",p(n)).replace("/* REPLACE_TESTNET_EXPORTS */",p(s,{testnet:true})).replace(/"(.+)":/g,"$1:").trim(),c=d.replace("/* REPLACE_MAINNET_DEFS */",h(n,{mjs:true})).replace("/* REPLACE_TESTNET_DEFS */",h(s,{mjs:true,testnet:true})).replace("/* REPLACE_MAINNET_CHAINS */",g(n)).replace("/* REPLACE_TESTNET_CHAINS */",g(s,{testnet:true})).replace("/* REPLACE_MAINNET_CHAINS_ARRAY */",p(n)).replace("/* REPLACE_TESTNET_CHAINS_ARRAY */",p(s,{testnet:true})).replace(/"(.+)":/g,"$1:").trim();await Promise.all([m__namespace.writeFile(u("index.js"),f,{encoding:"utf-8"}),m__namespace.writeFile(u("index.mjs"),c.replace('"../dist"','"../dist/index.mjs"'),{encoding:"utf-8"}),m__namespace.writeFile(u("index.ts"),c,{encoding:"utf-8"})]),console.log('\u2728	Generate complete! You can import `mainnetChains` and `testnetChains` from "graz/chains".\n');},A=(n,s)=>{if(!s)return n;let a=new Set(s.split(","));return Object.fromEntries(Object.entries(n).filter(([d])=>a.has(d)))},u=(...n)=>R__namespace.resolve(L,"../chains",...n),g=(n,{testnet:s=false}={})=>Object.keys(n).map(a=>`  ${_(a)}: ${_(a)},`).join(`
-`),h=(n,{mjs:s=false,testnet:a=false}={})=>Object.entries(n).map(([d,f])=>{let c=`${_(d)}`,e=JSON.stringify(f,null,2);return `${s?"export ":""}const ${c} = defineChainInfo(${e});
-`}).join(""),p=(n,{testnet:s=false}={})=>Object.keys(n).map(a=>`  ${_(a)},`).join(`
-`),S=async(n,{filter:s=""}={})=>{let a;if(s)a=s.split(",").map(e=>({path:e}));else try{a=(await n.fetchChains()).chains.map(({path:o})=>({path:o}));}catch(e){return console.error(`\u274C	Failed to fetch chains list: ${e.message}`),{}}let f=(await $__default.default(a,async e=>{try{return (await n.fetchChain(e.path)).chain}catch(o){return console.error(`\u274C	Failed to fetch chain "${e.path}": ${o.message}`),null}},{concurrency:4})).filter(e=>e!==null),c={};return f.forEach(e=>{try{if(r["--authz"]&&!e.params?.authz)return;let o=r["--best"]?e.best_apis:e.apis;if(!o||!o.rest?.[0]||!o.rpc?.[0])throw new Error(`\u26A0\uFE0F	${e.name} has no REST/RPC endpoints, skipping codegen...`);if(!e.assets)throw new Error(`\u26A0\uFE0F	${e.name} has no assets, skipping codegen...`);let l=e.assets[0],T={coinDenom:l.denom_units[l.denom_units.length-1].denom,coinMinimalDenom:l.denom_units[0].denom,coinDecimals:l.denom_units[l.denom_units.length-1].exponent,coinGeckoId:l.coingecko_id},E=e.fees?.fee_tokens.map(t=>t.low_gas_price&&t.average_gas_price&&t.high_gas_price?{coinDenom:e.assets?.find(i=>i.denom===t.denom)?.denom_units.at(-1)?.denom||t.denom,coinMinimalDenom:e.assets?.find(i=>i.denom===t.denom)?.denom_units[0]?.denom||t.denom,coinDecimals:Number(e.assets?.find(i=>i.denom===t.denom)?.decimals),coinGeckoId:e.assets?.find(i=>i.denom===t.denom)?.coingecko_id||void 0,gasPriceStep:{low:Number(t.low_gas_price),average:Number(t.average_gas_price),high:Number(t.high_gas_price)}}:{coinDenom:e.assets?.find(i=>i.denom===t.denom)?.denom_units.at(-1)?.denom||t.denom,coinMinimalDenom:e.assets?.find(i=>i.denom===t.denom)?.denom_units[0]?.denom||t.denom,coinDecimals:Number(e.assets?.find(i=>i.denom===t.denom)?.decimals),coinGeckoId:e.assets?.find(i=>i.denom===t.denom)?.coingecko_id||void 0});if(!E)throw new Error(`\u26A0\uFE0F	${e.name} has no fee currencies, skipping codegen...`);c[e.path]={chainId:e.chain_id,currencies:e.assets.map(t=>({coinDenom:t.denom_units[t.denom_units.length-1].denom,coinMinimalDenom:t.denom_units[0].denom,coinDecimals:t.denom_units[t.denom_units.length-1].exponent,coinGeckoId:t.coingecko_id})),rest:o.rest[0].address||"",rpc:o.rpc[0].address||"",bech32Config:cosmos.Bech32Address.defaultBech32Config(e.bech32_prefix),chainName:e.chain_name,feeCurrencies:E,stakeCurrency:T,bip44:{coinType:e.slip44??0}};}catch(o){console.error(o instanceof Error?o.message:String(o));}}),c};v();
+`,a=V__default.default({"--generate":Boolean,"-g":"--generate","--authz":Boolean,"--best":Boolean,"--mainnet":String,"--testnet":String,"-b":"--best","-M":"--mainnet","-T":"--testnet","--help":Boolean,"-h":"--help","--endpoint":String,"-e":"--endpoint"}),J=async()=>{if(a["--help"]){console.log(D);return}if(a["--generate"]){await K();return}console.log(D);},K=async()=>{console.log("\u23F3	Generating chain list..."),a["--authz"]&&console.log("\u270D\uFE0F	Detected authz flag, generating only compatible chains..."),a["--best"]&&console.log("\u{1F481}\u200D\u2642\uFE0F	Detected best flag, setting REST and RPC endpoints to best latency..."),(a["--mainnet"]||a["--testnet"])&&console.log("\u{1F419}	Detected chain filtering flag, generating only given chain paths...");let t,o;if(a["--endpoint"]){console.log("\u{1F310}	Fetching chain information from specified endpoint");try{let e=await fetch(a["--endpoint"]);if(!e.ok)throw new Error(`HTTP error! status: ${e.status}`);let r=await e.json();t=M(r.mainnet,a["--mainnet"]),o=M(r.testnet,a["--testnet"]);}catch(e){console.error(`\u274C	Failed to fetch chain information: ${e.message}`),process.exit(1);}}else [t,o]=await Promise.all([L(cosmosDirectoryClient.createClient(),{filter:a["--mainnet"]}),L(cosmosDirectoryClient.createTestnetClient(),{filter:a["--testnet"]})]);let[i,d]=await Promise.all([h__namespace.readFile(b("index.js.stub"),{encoding:"utf-8"}),h__namespace.readFile(b("index.mjs.stub"),{encoding:"utf-8"})]),c=i.replace("/* REPLACE_MAINNET_DEFS */",T(t)).replace("/* REPLACE_TESTNET_DEFS */",T(o,{testnet:true})).replace("/* REPLACE_MAINNET_CHAINS */",y(t)).replace("/* REPLACE_TESTNET_CHAINS */",y(o,{testnet:true})).replace("/* REPLACE_MAINNET_CHAINS_ARRAY */",E(t)).replace("/* REPLACE_TESTNET_CHAINS_ARRAY */",E(o,{testnet:true})).replace("/* REPLACE_MAINNET_EXPORTS */",E(t)).replace("/* REPLACE_TESTNET_EXPORTS */",E(o,{testnet:true})).replace(/"(.+)":/g,"$1:").trim(),l=d.replace("/* REPLACE_MAINNET_DEFS */",T(t,{mjs:true})).replace("/* REPLACE_TESTNET_DEFS */",T(o,{mjs:true,testnet:true})).replace("/* REPLACE_MAINNET_CHAINS */",y(t)).replace("/* REPLACE_TESTNET_CHAINS */",y(o,{testnet:true})).replace("/* REPLACE_MAINNET_CHAINS_ARRAY */",E(t)).replace("/* REPLACE_TESTNET_CHAINS_ARRAY */",E(o,{testnet:true})).replace(/"(.+)":/g,"$1:").trim();await Promise.all([h__namespace.writeFile(b("index.js"),c,{encoding:"utf-8"}),h__namespace.writeFile(b("index.mjs"),l.replace('"../dist"','"../dist/index.mjs"'),{encoding:"utf-8"}),h__namespace.writeFile(b("index.ts"),l,{encoding:"utf-8"})]),console.log('\u2728	Generate complete! You can import `mainnetChains` and `testnetChains` from "graz/chains".\n');},M=(t,o)=>{if(!o)return t;let i=new Set(o.split(","));return Object.fromEntries(Object.entries(t).filter(([d])=>i.has(d)))},b=(...t)=>F__namespace.resolve(q,"../chains",...t),y=(t,{testnet:o=false}={})=>Object.keys(t).map(i=>`  ${w(i)}: ${w(i)},`).join(`
+`),T=(t,{mjs:o=false,testnet:i=false}={})=>Object.entries(t).map(([d,c])=>{let l=`${w(d)}`,e=JSON.stringify(c,null,2);return `${o?"export ":""}const ${l} = defineChainInfo(${e});
+`}).join(""),E=(t,{testnet:o=false}={})=>Object.keys(t).map(i=>`  ${w(i)},`).join(`
+`),L=async(t,{filter:o=""}={})=>{let i;if(o)i=o.split(",").map(e=>({path:e}));else try{i=(await t.fetchChains()).chains.map(({path:r})=>({path:r}));}catch(e){return console.error(`\u274C	Failed to fetch chains list: ${e.message}`),{}}let c=(await R(i,async e=>{try{return (await t.fetchChain(e.path)).chain}catch(r){return console.error(`\u274C	Failed to fetch chain "${e.path}": ${r.message}`),null}},{concurrency:4})).filter(e=>e!==null),l={};return c.forEach(e=>{try{if(a["--authz"]&&!e.params?.authz)return;let r=a["--best"]?e.best_apis:e.apis;if(!r||!r.rest?.[0]||!r.rpc?.[0])throw new Error(`\u26A0\uFE0F	${e.name} has no REST/RPC endpoints, skipping codegen...`);if(!e.assets)throw new Error(`\u26A0\uFE0F	${e.name} has no assets, skipping codegen...`);let m=e.assets[0],_={coinDenom:m.denom_units[m.denom_units.length-1].denom,coinMinimalDenom:m.denom_units[0].denom,coinDecimals:m.denom_units[m.denom_units.length-1].exponent,coinGeckoId:m.coingecko_id},I=e.fees?.fee_tokens.map(n=>n.low_gas_price&&n.average_gas_price&&n.high_gas_price?{coinDenom:e.assets?.find(s=>s.denom===n.denom)?.denom_units.at(-1)?.denom||n.denom,coinMinimalDenom:e.assets?.find(s=>s.denom===n.denom)?.denom_units[0]?.denom||n.denom,coinDecimals:Number(e.assets?.find(s=>s.denom===n.denom)?.decimals),coinGeckoId:e.assets?.find(s=>s.denom===n.denom)?.coingecko_id||void 0,gasPriceStep:{low:Number(n.low_gas_price),average:Number(n.average_gas_price),high:Number(n.high_gas_price)}}:{coinDenom:e.assets?.find(s=>s.denom===n.denom)?.denom_units.at(-1)?.denom||n.denom,coinMinimalDenom:e.assets?.find(s=>s.denom===n.denom)?.denom_units[0]?.denom||n.denom,coinDecimals:Number(e.assets?.find(s=>s.denom===n.denom)?.decimals),coinGeckoId:e.assets?.find(s=>s.denom===n.denom)?.coingecko_id||void 0});if(!I)throw new Error(`\u26A0\uFE0F	${e.name} has no fee currencies, skipping codegen...`);l[e.path]={chainId:e.chain_id,currencies:e.assets.map(n=>({coinDenom:n.denom_units[n.denom_units.length-1].denom,coinMinimalDenom:n.denom_units[0].denom,coinDecimals:n.denom_units[n.denom_units.length-1].exponent,coinGeckoId:n.coingecko_id})),rest:r.rest[0].address||"",rpc:r.rpc[0].address||"",bech32Config:cosmos.Bech32Address.defaultBech32Config(e.bech32_prefix),chainName:e.chain_name,feeCurrencies:I,stakeCurrency:_,bip44:{coinType:e.slip44??0}};}catch(r){console.error(r instanceof Error?r.message:String(r));}}),l};J();

package/dist/index.d.mts

@@ -1,21 +1,18 @@
 /// <reference types="../types/global" />
+import { OfflineAminoSigner, StdSignature } from '@cosmjs/amino';
 import { DirectSignResponse, OfflineDirectSigner, Coin } from '@cosmjs/proto-signing';
-import { Key as Key$1, Keplr, ChainInfo, KeplrSignOptions, KeplrIntereactionOptions, OfflineAminoSigner as OfflineAminoSigner$1, AppCurrency } from '@keplr-wallet/types';
-import { OfflineAminoSigner } from '@cosmjs/amino';
+import { Keplr, ChainInfo, KeplrSignOptions, KeplrIntereactionOptions, Key as Key$1, AppCurrency } from '@keplr-wallet/types';
 import { WalletConnectModalConfig } from '@walletconnect/modal';
 import { SignClientTypes } from '@walletconnect/types';
 import * as _tanstack_react_query from '@tanstack/react-query';
-import { UseQueryResult } from '@tanstack/react-query';
+import { QueryClient, UseQueryResult } from '@tanstack/react-query';
 import { ParaWeb } from '@getpara/web-sdk';
 export { ParaWeb } from '@getpara/web-sdk';
-import { ParaGrazConfig as ParaGrazConfig$1, ParaGrazConnector } from '@getpara/graz-connector';
 import * as _cosmjs_cosmwasm_stargate from '@cosmjs/cosmwasm-stargate';
-import { SigningCosmWasmClient, InstantiateOptions, CosmWasmClient, InstantiateResult, ExecuteResult, SigningCosmWasmClientOptions } from '@cosmjs/cosmwasm-stargate';
-import { SigningStargateClient, StdFee, DeliverTxResponse, QueryClient, StakingExtension, StargateClient, SigningStargateClientOptions } from '@cosmjs/stargate';
-import { Height } from 'cosmjs-types/ibc/core/client/v1/client';
+import { SigningCosmWasmClient, InstantiateOptions, CosmWasmClient, ExecuteResult, InstantiateResult, SigningCosmWasmClientOptions } from '@cosmjs/cosmwasm-stargate';
+import { StdFee, SigningStargateClient, DeliverTxResponse, QueryClient as QueryClient$1, StakingExtension, StargateClient, SigningStargateClientOptions } from '@cosmjs/stargate';
 import { BondStatusString } from '@cosmjs/stargate/build/modules/staking/queries';
-import { QueryValidatorsResponse } from 'cosmjs-types/cosmos/staking/v1beta1/query';
-import { ReactNode, FC } from 'react';
+import { FC, ReactNode } from 'react';
 
 type Dictionary<T = string> = Record<string, T>;
 type Maybe<T> = T | undefined;
@@ -42,11 +39,12 @@ declare enum WalletType {
     CACTUSCOSMOS = "cactuscosmos"
 }
 declare const WALLET_TYPES: WalletType[];
-type Wallet = Pick<Keplr, "enable" | "getOfflineSignerOnlyAmino" | "signAmino"> & {
+type Wallet = Pick<Keplr, "enable" | "signAmino"> & {
     experimentalSuggestChain: (chainInfo: Omit<ChainInfo, "nodeProvider">) => Promise<void>;
     signArbitrary?: Keplr["signArbitrary"];
     signDirect: (...args: SignDirectParams) => Promise<DirectSignResponse>;
     getOfflineSigner: (chainId: string, signOptions?: KeplrSignOptions) => OfflineAminoSigner & OfflineDirectSigner;
+    getOfflineSignerOnlyAmino: (chainId: string, signOptions?: KeplrSignOptions) => OfflineAminoSigner;
     getOfflineSignerAuto: (chainId: string, signOptions?: KeplrSignOptions) => Promise<OfflineAminoSigner | OfflineDirectSigner>;
     subscription?: (reconnect: () => void) => () => void;
     init?: () => Promise<unknown>;
@@ -93,9 +91,9 @@ type ReconnectArgs = Maybe<{
 }>;
 declare const reconnect: (args?: ReconnectArgs) => Promise<ConnectResult | undefined>;
 interface OfflineSigners {
-    offlineSigner: OfflineAminoSigner$1 & OfflineDirectSigner;
-    offlineSignerAmino: OfflineAminoSigner$1;
-    offlineSignerAuto: OfflineAminoSigner$1 | OfflineDirectSigner;
+    offlineSigner: OfflineAminoSigner & OfflineDirectSigner;
+    offlineSignerAmino: OfflineAminoSigner;
+    offlineSignerAuto: OfflineAminoSigner | OfflineDirectSigner;
 }
 declare const getOfflineSigners: (args?: {
     walletType?: WalletType;
@@ -127,6 +125,92 @@ interface SuggestChainAndConnectArgs {
 }
 declare const suggestChainAndConnect: (args: SuggestChainAndConnectArgs) => Promise<ConnectResult>;
 
+/**
+ * Logger types and interfaces for Graz
+ */
+declare enum LogLevel {
+    ERROR = 0,
+    WARN = 1,
+    INFO = 2,
+    DEBUG = 3,
+    TRACE = 4
+}
+declare enum LogCategory {
+    WALLET = "wallet",// Wallet connections, disconnections
+    TRANSACTION = "transaction",// Transaction signing and broadcasting
+    QUERY = "query",// Blockchain queries
+    STORE = "store",// State management
+    MULTICHAIN = "multichain",// Multi-chain operations
+    EVENT = "event",// Wallet events
+    PERFORMANCE = "performance"
+}
+/**
+ * Error reporter interface for integration with error tracking services
+ * (e.g., Sentry, custom error tracking)
+ */
+interface ErrorReporter {
+    captureException: (error: Error, context?: {
+        category?: string;
+        context?: Record<string, unknown>;
+    }) => void;
+}
+/**
+ * Logger configuration options
+ */
+interface LoggerOptions {
+    /**
+     * Enable/disable logging
+     * @default true in development, false in production
+     */
+    enabled?: boolean;
+    /**
+     * Log level configuration:
+     * - Single LogLevel: Minimum level (e.g., LogLevel.INFO logs INFO, WARN, ERROR)
+     * - Array of LogLevel: Only log these specific levels
+     * - undefined/not specified: Log all levels
+     * @default undefined (all levels)
+     */
+    level?: LogLevel | LogLevel[];
+    /**
+     * Categories to log:
+     * - Array of categories: Only log these specific categories
+     * - Empty array or undefined: Log all categories
+     * @default undefined (all categories)
+     */
+    categories?: (keyof typeof LogCategory)[];
+    /**
+     * Optional error reporter for error tracking integration
+     */
+    errorReporter?: ErrorReporter;
+}
+/**
+ * Logger interface
+ */
+interface Logger {
+    error(category: LogCategory, message: string, context?: Record<string, unknown>): void;
+    warn(category: LogCategory, message: string, context?: Record<string, unknown>): void;
+    info(category: LogCategory, message: string, context?: Record<string, unknown>): void;
+    debug(category: LogCategory, message: string, context?: Record<string, unknown>): void;
+    trace(category: LogCategory, message: string, context?: Record<string, unknown>): void;
+    time(label: string): void;
+    timeEnd(label: string): void;
+    group(label: string): void;
+    groupEnd(): void;
+    setLevel(level: LogLevel | LogLevel[] | undefined): void;
+    setCategories(categories: (keyof typeof LogCategory)[] | undefined): void;
+    enable(): void;
+    disable(): void;
+}
+/**
+ * Global window extensions for Graz debugging
+ */
+declare global {
+    interface Window {
+        __GRAZ_DEBUG__?: boolean;
+        grazErrorReporter?: ErrorReporter;
+    }
+}
+
 /**
  * Para wallet entity (compatible with Wallet from @getpara/core-sdk)
  * Represents a wallet within the Para ecosystem (different from Graz Wallet)
@@ -157,9 +241,10 @@ interface ParaWallet {
 }
 /**
  * Event callbacks for Para wallet connector lifecycle events
- * Extracted from @getpara/graz-connector ParaGrazConfig
  */
-type ParaGrazConnectorEvents = NonNullable<ParaGrazConfig$1["events"]>;
+interface ParaGrazConnectorEvents {
+    onEnabled?: (chainIds: string[], connector: ParaGrazConnector) => void;
+}
 /**
  * Modal props for Para wallet UI
  * Compatible with ParaModalProps from @getpara/react-sdk-lite
@@ -210,7 +295,19 @@ interface ParaGrazConfig {
      * Should match the client used in your app's QueryClientProvider
      * Only needed when using @getpara/graz-integration with modal support
      */
-    queryClient?: _tanstack_react_query.QueryClient;
+    queryClient?: QueryClient;
+}
+/**
+ * Para wallet connector interface
+ *
+ * Structural contract for the connector instance provided by
+ * @getpara/graz-integration. Defined here so graz's published types stay
+ * self-contained and do not pin a specific @getpara/graz-connector install.
+ */
+interface ParaGrazConnector extends Pick<Wallet, "enable" | "getKey" | "getOfflineSigner" | "getOfflineSignerOnlyAmino" | "getOfflineSignerAuto" | "signAmino" | "signDirect"> {
+    disconnect: () => Promise<void>;
+    getParaWebClient: () => ParaWeb;
+    signArbitrary: (chainId: string, signer: string, data: string | Uint8Array) => Promise<StdSignature>;
 }
 
 interface ChainConfig {
@@ -258,6 +355,14 @@ interface GrazInternalStore {
      * Interval in milliseconds to ping the wallet.
      */
     pingInterval: number;
+    /**
+     * Logger configuration
+     */
+    loggerConfig: {
+        enabled: boolean;
+        level?: LogLevel | LogLevel[];
+        categories?: (keyof typeof LogCategory)[];
+    } | null;
     _notFoundFn: () => void;
     _reconnect: boolean;
     _reconnectConnector: WalletType | null;
@@ -288,9 +393,21 @@ interface ConfigureGrazArgs {
      */
     iframeOptions?: IframeOptions;
     pingInteval?: number;
+    /**
+     * Logger configuration
+     */
+    logger?: {
+        enabled?: boolean;
+        level?: LogLevel | LogLevel[] | undefined;
+        categories?: (keyof typeof LogCategory)[] | undefined;
+    };
 }
 declare const configureGraz: (args: ConfigureGrazArgs) => ConfigureGrazArgs;
 
+interface Height {
+    revisionNumber: bigint;
+    revisionHeight: bigint;
+}
 interface SendTokensArgs {
     signingClient?: SigningStargateClient | SigningCosmWasmClient;
     senderAddress?: string;
@@ -374,6 +491,88 @@ declare const isLeapDappBrowser: () => boolean;
 declare const isWalletConnect: (type: WalletType) => boolean;
 declare const isPara: (type: WalletType) => type is WalletType.PARA;
 
+/**
+ * Logger Categories
+ * Used for categorizing logs throughout the Graz library
+ */
+declare const LOG_CATEGORIES: {
+    /** Wallet connections, disconnections, and adapter operations */
+    readonly WALLET: "wallet";
+    /** Transaction signing and broadcasting */
+    readonly TRANSACTION: "transaction";
+    /** Blockchain queries (balance, contract queries, etc.) */
+    readonly QUERY: "query";
+    /** State management operations (store updates) */
+    readonly STORE: "store";
+    /** Multi-chain parallel operations */
+    readonly MULTICHAIN: "multichain";
+    /** Wallet events and listeners */
+    readonly EVENT: "event";
+    /** Performance metrics and timing */
+    readonly PERFORMANCE: "performance";
+};
+/**
+ * Logger Function Names
+ * Action/method function names used in logging context
+ */
+declare const LOG_FUNCTIONS: {
+    readonly CONNECT: "connect";
+    readonly DISCONNECT: "disconnect";
+    readonly RECONNECT: "reconnect";
+    readonly GET_WALLET: "getWallet";
+    readonly CLEAR_RECENT_CHAIN: "clearRecentChain";
+    readonly GET_RECENT_CHAIN_IDS: "getRecentChainIds";
+    readonly GET_RECENT_CHAINS: "getRecentChains";
+    readonly GET_CHAIN_INFO: "getChainInfo";
+    readonly GET_CHAIN_INFOS: "getChainInfos";
+    readonly ADD_CHAIN: "addChain";
+    readonly SUGGEST_CHAIN: "suggestChain";
+    readonly SUGGEST_CHAIN_AND_CONNECT: "suggestChainAndConnect";
+    readonly SEND_TOKENS: "sendTokens";
+    readonly SEND_IBC_TOKENS: "sendIbcTokens";
+    readonly INSTANTIATE_CONTRACT: "instantiateContract";
+    readonly EXECUTE_CONTRACT: "executeContract";
+    readonly GET_QUERY_SMART: "getQuerySmart";
+    readonly GET_QUERY_RAW: "getQueryRaw";
+    readonly CREATE_MULTI_CHAIN_ASYNC_FUNCTION: "createMultiChainAsyncFunction";
+    readonly HANDLE_FOCUS: "handleFocus";
+    readonly AUTO_CONNECT_IFRAME: "autoConnectIframe";
+    readonly RECONNECT_EFFECT: "reconnectEffect";
+    readonly SUBSCRIPTION: "subscription";
+};
+/**
+ * Logger Hook Names
+ * React hook names used in logging context
+ */
+declare const LOG_HOOKS: {
+    readonly USE_CONNECT: "useConnect";
+    readonly USE_DISCONNECT: "useDisconnect";
+    readonly USE_CHECK_WALLET: "useCheckWallet";
+    readonly USE_ADD_CHAIN: "useAddChain";
+    readonly USE_SUGGEST_CHAIN: "useSuggestChain";
+    readonly USE_SUGGEST_CHAIN_AND_CONNECT: "useSuggestChainAndConnect";
+    readonly USE_STARGATE_CLIENT: "useStargateClient";
+    readonly USE_COSMWASM_CLIENT: "useCosmWasmClient";
+    readonly USE_STARGATE_SIGNING_CLIENT: "useStargateSigningClient";
+    readonly USE_COSMWASM_SIGNING_CLIENT: "useCosmWasmSigningClient";
+    readonly USE_SEND_TOKENS: "useSendTokens";
+    readonly USE_SEND_IBC_TOKENS: "useSendIbcTokens";
+    readonly USE_INSTANTIATE_CONTRACT: "useInstantiateContract";
+    readonly USE_EXECUTE_CONTRACT: "useExecuteContract";
+};
+
+/**
+ * Get the singleton logger instance
+ * @returns Logger instance
+ */
+declare const getLogger: () => Logger;
+/**
+ * Configure the logger with custom options
+ * This will recreate the logger instance with new options
+ * @param options Logger configuration options
+ */
+declare const configureLogger: (options: LoggerOptions) => void;
+
 type CactusCosmosWallet = Pick<Keplr, "enable" | "getOfflineSigner" | "signDirect" | "signAmino" | "signArbitrary" | "getKey">;
 declare const getCactusCosmos: () => Wallet;
 
@@ -801,7 +1000,7 @@ declare const useDisconnect: ({ onError, onLoading, onSuccess }?: MutationEventA
 declare function useOfflineSigners<const TChainIds extends readonly string[]>(args: {
     chainId: TChainIds;
 }): UseMultiChainQueryResult<TChainIds, OfflineSigners>;
-declare function useOfflineSigners(args?: {}): UseMultiChainQueryResult<undefined, OfflineSigners>;
+declare function useOfflineSigners(args?: Record<string, never>): UseMultiChainQueryResult<undefined, OfflineSigners>;
 /**
  * graz query hook to retrieve staked balance for a specific chain and address.
  *
@@ -826,8 +1025,9 @@ declare function useOfflineSigners(args?: {}): UseMultiChainQueryResult<undefine
 declare const useBalanceStaked: (args: {
     bech32Address: string;
     chainId: string;
-} & QueryConfig) => UseQueryResult<Coin, unknown>;
+} & QueryConfig) => UseQueryResult<Coin | null, unknown>;
 
+type QueryValidatorsResponse = Awaited<ReturnType<StakingExtension["staking"]["validators"]>>;
 /**
  * graz hook to retrieve connected account's active chainIds
  *
@@ -911,7 +1111,7 @@ declare const useActiveChainCurrency: ({ denom }: {
  * const { data: response, ... } = useActiveChainValidators(queryClient);
  * ```
  */
-declare const useQueryClientValidators: <T extends QueryClient & StakingExtension>(args: {
+declare const useQueryClientValidators: <T extends QueryClient$1 & StakingExtension>(args: {
     queryClient: T | undefined;
     status?: BondStatusString;
 }) => UseQueryResult<QueryValidatorsResponse>;
@@ -1686,11 +1886,20 @@ interface GrazProviderProps {
  * Graz uses `@tanstack/react-query`'s features under the hood, hence you need to wrap `GrazProvider` with `QueryClientProvider`.
  * @example
  * ```tsx
+ * import { GrazProvider, LogLevel } from "graz";
+ *
  * // example next.js application in _app.tsx
  * export default function CustomApp({ Component, pageProps }: AppProps) {
  *   return (
  *     <QueryClientProvider queryClient={queryClient}>
- *       <GrazProvider grazOptions={grazOptions}>
+ *       <GrazProvider grazOptions={{
+ *         chains: [cosmoshubChainInfo, osmosisChainInfo],
+ *         logger: {
+ *           enabled: true,
+ *           level: LogLevel.DEBUG,
+ *           categories: ['wallet', 'transaction'],
+ *         }
+ *       }}>
  *         <Component {...pageProps} />
  *       </GrazProvider>
  *     </QueryClientProvider>
@@ -1715,4 +1924,4 @@ declare const useGrazEvents: () => null;
  */
 declare const GrazEvents: FC;
 
-export { type ActionChainId, type AddChainArgs, type CactusCosmosWallet, type ConfigureGrazArgs, type ConnectArgs, type ConnectResult, type Dictionary, type ExecuteContractArgs, type ExecuteContractMutationArgs, GrazEvents, GrazProvider, type GrazProviderProps, type InstantiateContractArgs, type InstantiateContractMutationArgs, type Key, type KnownKeys, type Maybe, type OfflineSigners, type ParaGrazConfig, type ParaGrazConnectorEvents, type ParaModalProps, type ParaWallet, type ReconnectArgs, type SendIbcTokensArgs, type SendTokensArgs, type SignAminoParams, type SignDirectParams, type SignDoc, type SuggestChainAndConnectArgs, type SuggestChainArgs, type UseAccountArgs, type UseAccountResult, type UseAddChainArgs, type UseConnectChainArgs, type UseExecuteContractArgs, type UseInstantiateContractArgs, type UseSuggestChainAndConnectArgs, type UseSuggestChainArgs, WALLET_TYPES, type Wallet, WalletType, addChain, checkWallet, clearRecentChain, clearSession, configureGraz, connect, defineChainInfo, defineChains, disconnect, executeContract, getAvailableWallets, getCactusCosmos, getChainInfo, getChainInfos, getCosmostation, getKeplr, getLeap, getMetamaskSnapLeap, getOfflineSigners, getOkx, getPara, getQueryRaw, getQuerySmart, getRecentChainIds, getRecentChains, getVectis, getWCCosmostation, getWCKeplr, getWCLeap, getWallet, getWalletConnect, instantiateContract, isLeapDappBrowser, isLeapSnaps, isPara, isWalletConnect, reconnect, sendIbcTokens, sendTokens, suggestChain, suggestChainAndConnect, useAccount, useActiveChainCurrency, useActiveChainIds, useActiveChains, useActiveWalletType, useAddChain, useBalance, useBalanceStaked, useBalances, useChainInfo, useChainInfos, useCheckWallet, useConnect, useCosmWasmClient, useCosmWasmSigningClient, useDisconnect, useExecuteContract, useGrazEvents, useInstantiateContract, useOfflineSigners, useQueryClientValidators, useQueryRaw, useQuerySmart, useRecentChainIds, useRecentChains, useSendIbcTokens, useSendTokens, useStargateClient, useStargateSigningClient, useSuggestChain, useSuggestChainAndConnect };
+export { type ActionChainId, type AddChainArgs, type CactusCosmosWallet, type ConfigureGrazArgs, type ConnectArgs, type ConnectResult, type Dictionary, type ErrorReporter, type ExecuteContractArgs, type ExecuteContractMutationArgs, GrazEvents, GrazProvider, type GrazProviderProps, type Height, type InstantiateContractArgs, type InstantiateContractMutationArgs, type Key, type KnownKeys, LOG_CATEGORIES, LOG_FUNCTIONS, LOG_HOOKS, LogCategory, LogLevel, type Logger, type LoggerOptions, type Maybe, type OfflineSigners, type ParaGrazConfig, type ParaGrazConnector, type ParaGrazConnectorEvents, type ParaModalProps, type ParaWallet, type ReconnectArgs, type SendIbcTokensArgs, type SendTokensArgs, type SignAminoParams, type SignDirectParams, type SignDoc, type SuggestChainAndConnectArgs, type SuggestChainArgs, type UseAccountArgs, type UseAccountResult, type UseAddChainArgs, type UseConnectChainArgs, type UseExecuteContractArgs, type UseInstantiateContractArgs, type UseSuggestChainAndConnectArgs, type UseSuggestChainArgs, WALLET_TYPES, type Wallet, WalletType, addChain, checkWallet, clearRecentChain, clearSession, configureGraz, configureLogger, connect, defineChainInfo, defineChains, disconnect, executeContract, getAvailableWallets, getCactusCosmos, getChainInfo, getChainInfos, getCosmostation, getKeplr, getLeap, getLogger, getMetamaskSnapLeap, getOfflineSigners, getOkx, getPara, getQueryRaw, getQuerySmart, getRecentChainIds, getRecentChains, getVectis, getWCCosmostation, getWCKeplr, getWCLeap, getWallet, getWalletConnect, instantiateContract, isLeapDappBrowser, isLeapSnaps, isPara, isWalletConnect, reconnect, sendIbcTokens, sendTokens, suggestChain, suggestChainAndConnect, useAccount, useActiveChainCurrency, useActiveChainIds, useActiveChains, useActiveWalletType, useAddChain, useBalance, useBalanceStaked, useBalances, useChainInfo, useChainInfos, useCheckWallet, useConnect, useCosmWasmClient, useCosmWasmSigningClient, useDisconnect, useExecuteContract, useGrazEvents, useInstantiateContract, useOfflineSigners, useQueryClientValidators, useQueryRaw, useQuerySmart, useRecentChainIds, useRecentChains, useSendIbcTokens, useSendTokens, useStargateClient, useStargateSigningClient, useSuggestChain, useSuggestChainAndConnect };