@gitmyabi-stg/uqc 1.0.0

package/contracts/UquidCoin.ts

@@ -0,0 +1,1702 @@
+import type { Abi, Address, PublicClient, WalletClient, GetContractReturnType } from 'viem';
+import { getContract } from 'viem';
+
+/**
+ * UquidCoin ABI
+ * 
+ * This ABI is typed using viem's type system for full type safety.
+ */
+export const UquidCoinAbi = [
+  {
+    "inputs": [
+      {
+        "internalType": "uint256",
+        "name": "_initialSupply",
+        "type": "uint256"
+      },
+      {
+        "internalType": "string",
+        "name": "_name",
+        "type": "string"
+      },
+      {
+        "internalType": "string",
+        "name": "_symbol",
+        "type": "string"
+      },
+      {
+        "internalType": "uint256",
+        "name": "_decimals",
+        "type": "uint256"
+      }
+    ],
+    "stateMutability": "nonpayable",
+    "type": "constructor"
+  },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": false,
+        "internalType": "address",
+        "name": "_user",
+        "type": "address"
+      }
+    ],
+    "name": "AddedBlackList",
+    "type": "event"
+  },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "owner",
+        "type": "address"
+      },
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "spender",
+        "type": "address"
+      },
+      {
+        "indexed": false,
+        "internalType": "uint256",
+        "name": "value",
+        "type": "uint256"
+      }
+    ],
+    "name": "Approval",
+    "type": "event"
+  },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": false,
+        "internalType": "address",
+        "name": "newAddress",
+        "type": "address"
+      }
+    ],
+    "name": "Deprecate",
+    "type": "event"
+  },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": false,
+        "internalType": "address",
+        "name": "_blackListedUser",
+        "type": "address"
+      },
+      {
+        "indexed": false,
+        "internalType": "uint256",
+        "name": "_balance",
+        "type": "uint256"
+      }
+    ],
+    "name": "DestroyedBlackFunds",
+    "type": "event"
+  },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": false,
+        "internalType": "uint256",
+        "name": "amount",
+        "type": "uint256"
+      }
+    ],
+    "name": "Issue",
+    "type": "event"
+  },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": false,
+        "internalType": "uint256",
+        "name": "feeBasisPoints",
+        "type": "uint256"
+      },
+      {
+        "indexed": false,
+        "internalType": "uint256",
+        "name": "maxFee",
+        "type": "uint256"
+      }
+    ],
+    "name": "Params",
+    "type": "event"
+  },
+  {
+    "anonymous": false,
+    "inputs": [],
+    "name": "Pause",
+    "type": "event"
+  },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": false,
+        "internalType": "uint256",
+        "name": "amount",
+        "type": "uint256"
+      }
+    ],
+    "name": "Redeem",
+    "type": "event"
+  },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": false,
+        "internalType": "address",
+        "name": "_user",
+        "type": "address"
+      }
+    ],
+    "name": "RemovedBlackList",
+    "type": "event"
+  },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "from",
+        "type": "address"
+      },
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "to",
+        "type": "address"
+      },
+      {
+        "indexed": false,
+        "internalType": "uint256",
+        "name": "value",
+        "type": "uint256"
+      }
+    ],
+    "name": "Transfer",
+    "type": "event"
+  },
+  {
+    "anonymous": false,
+    "inputs": [],
+    "name": "Unpause",
+    "type": "event"
+  },
+  {
+    "inputs": [],
+    "name": "MAX_UINT",
+    "outputs": [
+      {
+        "internalType": "uint256",
+        "name": "",
+        "type": "uint256"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [],
+    "name": "_totalSupply",
+    "outputs": [
+      {
+        "internalType": "uint256",
+        "name": "",
+        "type": "uint256"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "_evilUser",
+        "type": "address"
+      }
+    ],
+    "name": "addBlackList",
+    "outputs": [],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "_owner",
+        "type": "address"
+      },
+      {
+        "internalType": "address",
+        "name": "_spender",
+        "type": "address"
+      }
+    ],
+    "name": "allowance",
+    "outputs": [
+      {
+        "internalType": "uint256",
+        "name": "remaining",
+        "type": "uint256"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "",
+        "type": "address"
+      },
+      {
+        "internalType": "address",
+        "name": "",
+        "type": "address"
+      }
+    ],
+    "name": "allowed",
+    "outputs": [
+      {
+        "internalType": "uint256",
+        "name": "",
+        "type": "uint256"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "_spender",
+        "type": "address"
+      },
+      {
+        "internalType": "uint256",
+        "name": "_value",
+        "type": "uint256"
+      }
+    ],
+    "name": "approve",
+    "outputs": [],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "who",
+        "type": "address"
+      }
+    ],
+    "name": "balanceOf",
+    "outputs": [
+      {
+        "internalType": "uint256",
+        "name": "",
+        "type": "uint256"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "",
+        "type": "address"
+      }
+    ],
+    "name": "balances",
+    "outputs": [
+      {
+        "internalType": "uint256",
+        "name": "",
+        "type": "uint256"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [],
+    "name": "basisPointsRate",
+    "outputs": [
+      {
+        "internalType": "uint256",
+        "name": "",
+        "type": "uint256"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [],
+    "name": "decimals",
+    "outputs": [
+      {
+        "internalType": "uint256",
+        "name": "",
+        "type": "uint256"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "_upgradedAddress",
+        "type": "address"
+      }
+    ],
+    "name": "deprecate",
+    "outputs": [],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
+  {
+    "inputs": [],
+    "name": "deprecated",
+    "outputs": [
+      {
+        "internalType": "bool",
+        "name": "",
+        "type": "bool"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "_blackListedUser",
+        "type": "address"
+      }
+    ],
+    "name": "destroyBlackFunds",
+    "outputs": [],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "_maker",
+        "type": "address"
+      }
+    ],
+    "name": "getBlackListStatus",
+    "outputs": [
+      {
+        "internalType": "bool",
+        "name": "",
+        "type": "bool"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [],
+    "name": "getOwner",
+    "outputs": [
+      {
+        "internalType": "address",
+        "name": "",
+        "type": "address"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "",
+        "type": "address"
+      }
+    ],
+    "name": "isBlackListed",
+    "outputs": [
+      {
+        "internalType": "bool",
+        "name": "",
+        "type": "bool"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "uint256",
+        "name": "amount",
+        "type": "uint256"
+      }
+    ],
+    "name": "issue",
+    "outputs": [],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
+  {
+    "inputs": [],
+    "name": "maximumFee",
+    "outputs": [
+      {
+        "internalType": "uint256",
+        "name": "",
+        "type": "uint256"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [],
+    "name": "name",
+    "outputs": [
+      {
+        "internalType": "string",
+        "name": "",
+        "type": "string"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [],
+    "name": "owner",
+    "outputs": [
+      {
+        "internalType": "address",
+        "name": "",
+        "type": "address"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [],
+    "name": "pause",
+    "outputs": [],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
+  {
+    "inputs": [],
+    "name": "paused",
+    "outputs": [
+      {
+        "internalType": "bool",
+        "name": "",
+        "type": "bool"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "uint256",
+        "name": "amount",
+        "type": "uint256"
+      }
+    ],
+    "name": "redeem",
+    "outputs": [],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "_clearedUser",
+        "type": "address"
+      }
+    ],
+    "name": "removeBlackList",
+    "outputs": [],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "uint256",
+        "name": "newBasisPoints",
+        "type": "uint256"
+      },
+      {
+        "internalType": "uint256",
+        "name": "newMaxFee",
+        "type": "uint256"
+      }
+    ],
+    "name": "setParams",
+    "outputs": [],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
+  {
+    "inputs": [],
+    "name": "symbol",
+    "outputs": [
+      {
+        "internalType": "string",
+        "name": "",
+        "type": "string"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [],
+    "name": "totalSupply",
+    "outputs": [
+      {
+        "internalType": "uint256",
+        "name": "",
+        "type": "uint256"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "_to",
+        "type": "address"
+      },
+      {
+        "internalType": "uint256",
+        "name": "_value",
+        "type": "uint256"
+      }
+    ],
+    "name": "transfer",
+    "outputs": [],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "_from",
+        "type": "address"
+      },
+      {
+        "internalType": "address",
+        "name": "_to",
+        "type": "address"
+      },
+      {
+        "internalType": "uint256",
+        "name": "_value",
+        "type": "uint256"
+      }
+    ],
+    "name": "transferFrom",
+    "outputs": [],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "newOwner",
+        "type": "address"
+      }
+    ],
+    "name": "transferOwnership",
+    "outputs": [],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
+  {
+    "inputs": [],
+    "name": "unpause",
+    "outputs": [],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
+  {
+    "inputs": [],
+    "name": "upgradedAddress",
+    "outputs": [
+      {
+        "internalType": "address",
+        "name": "",
+        "type": "address"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  }
+] as const satisfies Abi;
+
+/**
+ * Type-safe ABI for UquidCoin
+ */
+export type UquidCoinAbi = typeof UquidCoinAbi;
+
+/**
+ * Contract instance type for UquidCoin
+ */
+// Use any for contract type to avoid complex viem type issues
+// The runtime behavior is type-safe through viem's ABI typing
+export type UquidCoinContract = any;
+
+/**
+ * UquidCoin Contract Class
+ * 
+ * Provides a class-based API similar to TypeChain for interacting with the contract.
+ * 
+ * @example
+ * ```typescript
+ * import { createPublicClient, createWalletClient, http } from 'viem';
+ * import { mainnet } from 'viem/chains';
+ * import { UquidCoin } from 'UquidCoin';
+ * 
+ * const publicClient = createPublicClient({ chain: mainnet, transport: http() });
+ * const walletClient = createWalletClient({ chain: mainnet, transport: http() });
+ * 
+ * const contract = new UquidCoin('0x...', { publicClient, walletClient });
+ * 
+ * // Read functions
+ * const result = await contract.balanceOf('0x...');
+ * 
+ * // Write functions
+ * const hash = await contract.transfer('0x...', 1000n);
+ * 
+ * // Simulate transactions (dry-run)
+ * const simulation = await contract.simulate.transfer('0x...', 1000n);
+ * console.log('Gas estimate:', simulation.request.gas);
+ * 
+ * // Watch events
+ * const unwatch = contract.watch.Transfer((event) => {
+ *   console.log('Transfer event:', event);
+ * });
+ * ```
+ */
+export class UquidCoin {
+  private contract: UquidCoinContract;
+  private contractAddress: Address;
+  private publicClient: PublicClient;
+
+  constructor(
+    address: Address,
+    clients: {
+      publicClient: PublicClient;
+      walletClient?: WalletClient;
+    }
+  ) {
+    this.contractAddress = address;
+    this.publicClient = clients.publicClient;
+    this.contract = getContract({
+      address,
+      abi: UquidCoinAbi,
+      client: {
+        public: clients.publicClient,
+        wallet: clients.walletClient,
+      },
+    });
+  }
+
+  /**
+   * Get the contract address
+   */
+  get address(): Address {
+    return this.contractAddress;
+  }
+
+  /**
+   * Get the underlying viem contract instance.
+   */
+  getContract(): UquidCoinContract {
+    return this.contract;
+  }
+
+  /**
+   * MAX_UINT
+   * view
+   */
+  async MAX_UINT(): Promise<bigint> {
+    return this.contract.read.MAX_UINT() as Promise<bigint>;
+  }
+
+  /**
+   * _totalSupply
+   * view
+   */
+  async _totalSupply(): Promise<bigint> {
+    return this.contract.read._totalSupply() as Promise<bigint>;
+  }
+
+  /**
+   * allowance
+   * view
+   */
+  async allowance(_owner: `0x${string}`, _spender: `0x${string}`): Promise<bigint> {
+    return this.contract.read.allowance([_owner, _spender] as const) as Promise<bigint>;
+  }
+
+  /**
+   * allowed
+   * view
+   */
+  async allowed(arg0: `0x${string}`, arg1: `0x${string}`): Promise<bigint> {
+    return this.contract.read.allowed([arg0, arg1] as const) as Promise<bigint>;
+  }
+
+  /**
+   * balanceOf
+   * view
+   */
+  async balanceOf(who: `0x${string}`): Promise<bigint> {
+    return this.contract.read.balanceOf([who] as const) as Promise<bigint>;
+  }
+
+  /**
+   * balances
+   * view
+   */
+  async balances(arg0: `0x${string}`): Promise<bigint> {
+    return this.contract.read.balances([arg0] as const) as Promise<bigint>;
+  }
+
+  /**
+   * basisPointsRate
+   * view
+   */
+  async basisPointsRate(): Promise<bigint> {
+    return this.contract.read.basisPointsRate() as Promise<bigint>;
+  }
+
+  /**
+   * decimals
+   * view
+   */
+  async decimals(): Promise<bigint> {
+    return this.contract.read.decimals() as Promise<bigint>;
+  }
+
+  /**
+   * deprecated
+   * view
+   */
+  async deprecated(): Promise<boolean> {
+    return this.contract.read.deprecated() as Promise<boolean>;
+  }
+
+  /**
+   * getBlackListStatus
+   * view
+   */
+  async getBlackListStatus(_maker: `0x${string}`): Promise<boolean> {
+    return this.contract.read.getBlackListStatus([_maker] as const) as Promise<boolean>;
+  }
+
+  /**
+   * getOwner
+   * view
+   */
+  async getOwner(): Promise<`0x${string}`> {
+    return this.contract.read.getOwner() as Promise<`0x${string}`>;
+  }
+
+  /**
+   * isBlackListed
+   * view
+   */
+  async isBlackListed(arg0: `0x${string}`): Promise<boolean> {
+    return this.contract.read.isBlackListed([arg0] as const) as Promise<boolean>;
+  }
+
+  /**
+   * maximumFee
+   * view
+   */
+  async maximumFee(): Promise<bigint> {
+    return this.contract.read.maximumFee() as Promise<bigint>;
+  }
+
+  /**
+   * name
+   * view
+   */
+  async name(): Promise<string> {
+    return this.contract.read.name() as Promise<string>;
+  }
+
+  /**
+   * owner
+   * view
+   */
+  async owner(): Promise<`0x${string}`> {
+    return this.contract.read.owner() as Promise<`0x${string}`>;
+  }
+
+  /**
+   * paused
+   * view
+   */
+  async paused(): Promise<boolean> {
+    return this.contract.read.paused() as Promise<boolean>;
+  }
+
+  /**
+   * symbol
+   * view
+   */
+  async symbol(): Promise<string> {
+    return this.contract.read.symbol() as Promise<string>;
+  }
+
+  /**
+   * totalSupply
+   * view
+   */
+  async totalSupply(): Promise<bigint> {
+    return this.contract.read.totalSupply() as Promise<bigint>;
+  }
+
+  /**
+   * upgradedAddress
+   * view
+   */
+  async upgradedAddress(): Promise<`0x${string}`> {
+    return this.contract.read.upgradedAddress() as Promise<`0x${string}`>;
+  }
+
+  /**
+   * addBlackList
+   * nonpayable
+   * @param options Optional transaction parameters (value, gas, nonce, etc.)
+   */
+  async addBlackList(_evilUser: `0x${string}`, options?: {
+    accessList?: import('viem').AccessList;
+    authorizationList?: import('viem').AuthorizationList;
+    chain?: import('viem').Chain | null;
+    dataSuffix?: `0x${string}`;
+    gas?: bigint;
+    gasPrice?: bigint;
+    maxFeePerGas?: bigint;
+    maxPriorityFeePerGas?: bigint;
+    nonce?: number;
+    value?: bigint;
+  }): Promise<`0x${string}`> {
+    if (!this.contract.write) {
+      throw new Error('Wallet client is required for write operations');
+    }
+    return this.contract.write.addBlackList([_evilUser] as const, options) as Promise<`0x${string}`>;
+  }
+
+  /**
+   * approve
+   * nonpayable
+   * @param options Optional transaction parameters (value, gas, nonce, etc.)
+   */
+  async approve(_spender: `0x${string}`, _value: bigint, options?: {
+    accessList?: import('viem').AccessList;
+    authorizationList?: import('viem').AuthorizationList;
+    chain?: import('viem').Chain | null;
+    dataSuffix?: `0x${string}`;
+    gas?: bigint;
+    gasPrice?: bigint;
+    maxFeePerGas?: bigint;
+    maxPriorityFeePerGas?: bigint;
+    nonce?: number;
+    value?: bigint;
+  }): Promise<`0x${string}`> {
+    if (!this.contract.write) {
+      throw new Error('Wallet client is required for write operations');
+    }
+    return this.contract.write.approve([_spender, _value] as const, options) as Promise<`0x${string}`>;
+  }
+
+  /**
+   * deprecate
+   * nonpayable
+   * @param options Optional transaction parameters (value, gas, nonce, etc.)
+   */
+  async deprecate(_upgradedAddress: `0x${string}`, options?: {
+    accessList?: import('viem').AccessList;
+    authorizationList?: import('viem').AuthorizationList;
+    chain?: import('viem').Chain | null;
+    dataSuffix?: `0x${string}`;
+    gas?: bigint;
+    gasPrice?: bigint;
+    maxFeePerGas?: bigint;
+    maxPriorityFeePerGas?: bigint;
+    nonce?: number;
+    value?: bigint;
+  }): Promise<`0x${string}`> {
+    if (!this.contract.write) {
+      throw new Error('Wallet client is required for write operations');
+    }
+    return this.contract.write.deprecate([_upgradedAddress] as const, options) as Promise<`0x${string}`>;
+  }
+
+  /**
+   * destroyBlackFunds
+   * nonpayable
+   * @param options Optional transaction parameters (value, gas, nonce, etc.)
+   */
+  async destroyBlackFunds(_blackListedUser: `0x${string}`, options?: {
+    accessList?: import('viem').AccessList;
+    authorizationList?: import('viem').AuthorizationList;
+    chain?: import('viem').Chain | null;
+    dataSuffix?: `0x${string}`;
+    gas?: bigint;
+    gasPrice?: bigint;
+    maxFeePerGas?: bigint;
+    maxPriorityFeePerGas?: bigint;
+    nonce?: number;
+    value?: bigint;
+  }): Promise<`0x${string}`> {
+    if (!this.contract.write) {
+      throw new Error('Wallet client is required for write operations');
+    }
+    return this.contract.write.destroyBlackFunds([_blackListedUser] as const, options) as Promise<`0x${string}`>;
+  }
+
+  /**
+   * issue
+   * nonpayable
+   * @param options Optional transaction parameters (value, gas, nonce, etc.)
+   */
+  async issue(amount: bigint, options?: {
+    accessList?: import('viem').AccessList;
+    authorizationList?: import('viem').AuthorizationList;
+    chain?: import('viem').Chain | null;
+    dataSuffix?: `0x${string}`;
+    gas?: bigint;
+    gasPrice?: bigint;
+    maxFeePerGas?: bigint;
+    maxPriorityFeePerGas?: bigint;
+    nonce?: number;
+    value?: bigint;
+  }): Promise<`0x${string}`> {
+    if (!this.contract.write) {
+      throw new Error('Wallet client is required for write operations');
+    }
+    return this.contract.write.issue([amount] as const, options) as Promise<`0x${string}`>;
+  }
+
+  /**
+   * pause
+   * nonpayable
+   * @param options Optional transaction parameters (value, gas, nonce, etc.)
+   */
+  async pause(options?: {
+    accessList?: import('viem').AccessList;
+    authorizationList?: import('viem').AuthorizationList;
+    chain?: import('viem').Chain | null;
+    dataSuffix?: `0x${string}`;
+    gas?: bigint;
+    gasPrice?: bigint;
+    maxFeePerGas?: bigint;
+    maxPriorityFeePerGas?: bigint;
+    nonce?: number;
+    value?: bigint;
+  }): Promise<`0x${string}`> {
+    if (!this.contract.write) {
+      throw new Error('Wallet client is required for write operations');
+    }
+    return this.contract.write.pause(options) as Promise<`0x${string}`>;
+  }
+
+  /**
+   * redeem
+   * nonpayable
+   * @param options Optional transaction parameters (value, gas, nonce, etc.)
+   */
+  async redeem(amount: bigint, options?: {
+    accessList?: import('viem').AccessList;
+    authorizationList?: import('viem').AuthorizationList;
+    chain?: import('viem').Chain | null;
+    dataSuffix?: `0x${string}`;
+    gas?: bigint;
+    gasPrice?: bigint;
+    maxFeePerGas?: bigint;
+    maxPriorityFeePerGas?: bigint;
+    nonce?: number;
+    value?: bigint;
+  }): Promise<`0x${string}`> {
+    if (!this.contract.write) {
+      throw new Error('Wallet client is required for write operations');
+    }
+    return this.contract.write.redeem([amount] as const, options) as Promise<`0x${string}`>;
+  }
+
+  /**
+   * removeBlackList
+   * nonpayable
+   * @param options Optional transaction parameters (value, gas, nonce, etc.)
+   */
+  async removeBlackList(_clearedUser: `0x${string}`, options?: {
+    accessList?: import('viem').AccessList;
+    authorizationList?: import('viem').AuthorizationList;
+    chain?: import('viem').Chain | null;
+    dataSuffix?: `0x${string}`;
+    gas?: bigint;
+    gasPrice?: bigint;
+    maxFeePerGas?: bigint;
+    maxPriorityFeePerGas?: bigint;
+    nonce?: number;
+    value?: bigint;
+  }): Promise<`0x${string}`> {
+    if (!this.contract.write) {
+      throw new Error('Wallet client is required for write operations');
+    }
+    return this.contract.write.removeBlackList([_clearedUser] as const, options) as Promise<`0x${string}`>;
+  }
+
+  /**
+   * setParams
+   * nonpayable
+   * @param options Optional transaction parameters (value, gas, nonce, etc.)
+   */
+  async setParams(newBasisPoints: bigint, newMaxFee: bigint, options?: {
+    accessList?: import('viem').AccessList;
+    authorizationList?: import('viem').AuthorizationList;
+    chain?: import('viem').Chain | null;
+    dataSuffix?: `0x${string}`;
+    gas?: bigint;
+    gasPrice?: bigint;
+    maxFeePerGas?: bigint;
+    maxPriorityFeePerGas?: bigint;
+    nonce?: number;
+    value?: bigint;
+  }): Promise<`0x${string}`> {
+    if (!this.contract.write) {
+      throw new Error('Wallet client is required for write operations');
+    }
+    return this.contract.write.setParams([newBasisPoints, newMaxFee] as const, options) as Promise<`0x${string}`>;
+  }
+
+  /**
+   * transfer
+   * nonpayable
+   * @param options Optional transaction parameters (value, gas, nonce, etc.)
+   */
+  async transfer(_to: `0x${string}`, _value: bigint, options?: {
+    accessList?: import('viem').AccessList;
+    authorizationList?: import('viem').AuthorizationList;
+    chain?: import('viem').Chain | null;
+    dataSuffix?: `0x${string}`;
+    gas?: bigint;
+    gasPrice?: bigint;
+    maxFeePerGas?: bigint;
+    maxPriorityFeePerGas?: bigint;
+    nonce?: number;
+    value?: bigint;
+  }): Promise<`0x${string}`> {
+    if (!this.contract.write) {
+      throw new Error('Wallet client is required for write operations');
+    }
+    return this.contract.write.transfer([_to, _value] as const, options) as Promise<`0x${string}`>;
+  }
+
+  /**
+   * transferFrom
+   * nonpayable
+   * @param options Optional transaction parameters (value, gas, nonce, etc.)
+   */
+  async transferFrom(_from: `0x${string}`, _to: `0x${string}`, _value: bigint, options?: {
+    accessList?: import('viem').AccessList;
+    authorizationList?: import('viem').AuthorizationList;
+    chain?: import('viem').Chain | null;
+    dataSuffix?: `0x${string}`;
+    gas?: bigint;
+    gasPrice?: bigint;
+    maxFeePerGas?: bigint;
+    maxPriorityFeePerGas?: bigint;
+    nonce?: number;
+    value?: bigint;
+  }): Promise<`0x${string}`> {
+    if (!this.contract.write) {
+      throw new Error('Wallet client is required for write operations');
+    }
+    return this.contract.write.transferFrom([_from, _to, _value] as const, options) as Promise<`0x${string}`>;
+  }
+
+  /**
+   * transferOwnership
+   * nonpayable
+   * @param options Optional transaction parameters (value, gas, nonce, etc.)
+   */
+  async transferOwnership(newOwner: `0x${string}`, options?: {
+    accessList?: import('viem').AccessList;
+    authorizationList?: import('viem').AuthorizationList;
+    chain?: import('viem').Chain | null;
+    dataSuffix?: `0x${string}`;
+    gas?: bigint;
+    gasPrice?: bigint;
+    maxFeePerGas?: bigint;
+    maxPriorityFeePerGas?: bigint;
+    nonce?: number;
+    value?: bigint;
+  }): Promise<`0x${string}`> {
+    if (!this.contract.write) {
+      throw new Error('Wallet client is required for write operations');
+    }
+    return this.contract.write.transferOwnership([newOwner] as const, options) as Promise<`0x${string}`>;
+  }
+
+  /**
+   * unpause
+   * nonpayable
+   * @param options Optional transaction parameters (value, gas, nonce, etc.)
+   */
+  async unpause(options?: {
+    accessList?: import('viem').AccessList;
+    authorizationList?: import('viem').AuthorizationList;
+    chain?: import('viem').Chain | null;
+    dataSuffix?: `0x${string}`;
+    gas?: bigint;
+    gasPrice?: bigint;
+    maxFeePerGas?: bigint;
+    maxPriorityFeePerGas?: bigint;
+    nonce?: number;
+    value?: bigint;
+  }): Promise<`0x${string}`> {
+    if (!this.contract.write) {
+      throw new Error('Wallet client is required for write operations');
+    }
+    return this.contract.write.unpause(options) as Promise<`0x${string}`>;
+  }
+
+
+
+  /**
+   * Simulate contract write operations (dry-run without sending transaction)
+   * 
+   * @example
+   * const result = await contract.simulate.transfer('0x...', 1000n);
+   * console.log('Gas estimate:', result.request.gas);
+   * console.log('Would succeed:', result.result);
+   */
+  get simulate() {
+    const contract = this.contract;
+    if (!contract.simulate) {
+      throw new Error('Public client is required for simulation');
+    }
+    return {
+      /**
+       * Simulate addBlackList
+       * Returns gas estimate and result without sending transaction
+       * @param options Optional transaction parameters (value, gas, nonce, etc.)
+       */
+      async addBlackList(_evilUser: `0x${string}`, options?: {
+        accessList?: import('viem').AccessList;
+        authorizationList?: import('viem').AuthorizationList;
+        chain?: import('viem').Chain | null;
+        dataSuffix?: `0x${string}`;
+        gas?: bigint;
+        gasPrice?: bigint;
+        maxFeePerGas?: bigint;
+        maxPriorityFeePerGas?: bigint;
+        nonce?: number;
+        value?: bigint;
+      }): Promise<void> {
+        return contract.simulate.addBlackList([_evilUser] as const, options) as Promise<void>;
+      },
+      /**
+       * Simulate approve
+       * Returns gas estimate and result without sending transaction
+       * @param options Optional transaction parameters (value, gas, nonce, etc.)
+       */
+      async approve(_spender: `0x${string}`, _value: bigint, options?: {
+        accessList?: import('viem').AccessList;
+        authorizationList?: import('viem').AuthorizationList;
+        chain?: import('viem').Chain | null;
+        dataSuffix?: `0x${string}`;
+        gas?: bigint;
+        gasPrice?: bigint;
+        maxFeePerGas?: bigint;
+        maxPriorityFeePerGas?: bigint;
+        nonce?: number;
+        value?: bigint;
+      }): Promise<void> {
+        return contract.simulate.approve([_spender, _value] as const, options) as Promise<void>;
+      },
+      /**
+       * Simulate deprecate
+       * Returns gas estimate and result without sending transaction
+       * @param options Optional transaction parameters (value, gas, nonce, etc.)
+       */
+      async deprecate(_upgradedAddress: `0x${string}`, options?: {
+        accessList?: import('viem').AccessList;
+        authorizationList?: import('viem').AuthorizationList;
+        chain?: import('viem').Chain | null;
+        dataSuffix?: `0x${string}`;
+        gas?: bigint;
+        gasPrice?: bigint;
+        maxFeePerGas?: bigint;
+        maxPriorityFeePerGas?: bigint;
+        nonce?: number;
+        value?: bigint;
+      }): Promise<void> {
+        return contract.simulate.deprecate([_upgradedAddress] as const, options) as Promise<void>;
+      },
+      /**
+       * Simulate destroyBlackFunds
+       * Returns gas estimate and result without sending transaction
+       * @param options Optional transaction parameters (value, gas, nonce, etc.)
+       */
+      async destroyBlackFunds(_blackListedUser: `0x${string}`, options?: {
+        accessList?: import('viem').AccessList;
+        authorizationList?: import('viem').AuthorizationList;
+        chain?: import('viem').Chain | null;
+        dataSuffix?: `0x${string}`;
+        gas?: bigint;
+        gasPrice?: bigint;
+        maxFeePerGas?: bigint;
+        maxPriorityFeePerGas?: bigint;
+        nonce?: number;
+        value?: bigint;
+      }): Promise<void> {
+        return contract.simulate.destroyBlackFunds([_blackListedUser] as const, options) as Promise<void>;
+      },
+      /**
+       * Simulate issue
+       * Returns gas estimate and result without sending transaction
+       * @param options Optional transaction parameters (value, gas, nonce, etc.)
+       */
+      async issue(amount: bigint, options?: {
+        accessList?: import('viem').AccessList;
+        authorizationList?: import('viem').AuthorizationList;
+        chain?: import('viem').Chain | null;
+        dataSuffix?: `0x${string}`;
+        gas?: bigint;
+        gasPrice?: bigint;
+        maxFeePerGas?: bigint;
+        maxPriorityFeePerGas?: bigint;
+        nonce?: number;
+        value?: bigint;
+      }): Promise<void> {
+        return contract.simulate.issue([amount] as const, options) as Promise<void>;
+      },
+      /**
+       * Simulate pause
+       * Returns gas estimate and result without sending transaction
+       * @param options Optional transaction parameters (value, gas, nonce, etc.)
+       */
+      async pause(options?: {
+        accessList?: import('viem').AccessList;
+        authorizationList?: import('viem').AuthorizationList;
+        chain?: import('viem').Chain | null;
+        dataSuffix?: `0x${string}`;
+        gas?: bigint;
+        gasPrice?: bigint;
+        maxFeePerGas?: bigint;
+        maxPriorityFeePerGas?: bigint;
+        nonce?: number;
+        value?: bigint;
+      }): Promise<void> {
+        return contract.simulate.pause(options) as Promise<void>;
+      },
+      /**
+       * Simulate redeem
+       * Returns gas estimate and result without sending transaction
+       * @param options Optional transaction parameters (value, gas, nonce, etc.)
+       */
+      async redeem(amount: bigint, options?: {
+        accessList?: import('viem').AccessList;
+        authorizationList?: import('viem').AuthorizationList;
+        chain?: import('viem').Chain | null;
+        dataSuffix?: `0x${string}`;
+        gas?: bigint;
+        gasPrice?: bigint;
+        maxFeePerGas?: bigint;
+        maxPriorityFeePerGas?: bigint;
+        nonce?: number;
+        value?: bigint;
+      }): Promise<void> {
+        return contract.simulate.redeem([amount] as const, options) as Promise<void>;
+      },
+      /**
+       * Simulate removeBlackList
+       * Returns gas estimate and result without sending transaction
+       * @param options Optional transaction parameters (value, gas, nonce, etc.)
+       */
+      async removeBlackList(_clearedUser: `0x${string}`, options?: {
+        accessList?: import('viem').AccessList;
+        authorizationList?: import('viem').AuthorizationList;
+        chain?: import('viem').Chain | null;
+        dataSuffix?: `0x${string}`;
+        gas?: bigint;
+        gasPrice?: bigint;
+        maxFeePerGas?: bigint;
+        maxPriorityFeePerGas?: bigint;
+        nonce?: number;
+        value?: bigint;
+      }): Promise<void> {
+        return contract.simulate.removeBlackList([_clearedUser] as const, options) as Promise<void>;
+      },
+      /**
+       * Simulate setParams
+       * Returns gas estimate and result without sending transaction
+       * @param options Optional transaction parameters (value, gas, nonce, etc.)
+       */
+      async setParams(newBasisPoints: bigint, newMaxFee: bigint, options?: {
+        accessList?: import('viem').AccessList;
+        authorizationList?: import('viem').AuthorizationList;
+        chain?: import('viem').Chain | null;
+        dataSuffix?: `0x${string}`;
+        gas?: bigint;
+        gasPrice?: bigint;
+        maxFeePerGas?: bigint;
+        maxPriorityFeePerGas?: bigint;
+        nonce?: number;
+        value?: bigint;
+      }): Promise<void> {
+        return contract.simulate.setParams([newBasisPoints, newMaxFee] as const, options) as Promise<void>;
+      },
+      /**
+       * Simulate transfer
+       * Returns gas estimate and result without sending transaction
+       * @param options Optional transaction parameters (value, gas, nonce, etc.)
+       */
+      async transfer(_to: `0x${string}`, _value: bigint, options?: {
+        accessList?: import('viem').AccessList;
+        authorizationList?: import('viem').AuthorizationList;
+        chain?: import('viem').Chain | null;
+        dataSuffix?: `0x${string}`;
+        gas?: bigint;
+        gasPrice?: bigint;
+        maxFeePerGas?: bigint;
+        maxPriorityFeePerGas?: bigint;
+        nonce?: number;
+        value?: bigint;
+      }): Promise<void> {
+        return contract.simulate.transfer([_to, _value] as const, options) as Promise<void>;
+      },
+      /**
+       * Simulate transferFrom
+       * Returns gas estimate and result without sending transaction
+       * @param options Optional transaction parameters (value, gas, nonce, etc.)
+       */
+      async transferFrom(_from: `0x${string}`, _to: `0x${string}`, _value: bigint, options?: {
+        accessList?: import('viem').AccessList;
+        authorizationList?: import('viem').AuthorizationList;
+        chain?: import('viem').Chain | null;
+        dataSuffix?: `0x${string}`;
+        gas?: bigint;
+        gasPrice?: bigint;
+        maxFeePerGas?: bigint;
+        maxPriorityFeePerGas?: bigint;
+        nonce?: number;
+        value?: bigint;
+      }): Promise<void> {
+        return contract.simulate.transferFrom([_from, _to, _value] as const, options) as Promise<void>;
+      },
+      /**
+       * Simulate transferOwnership
+       * Returns gas estimate and result without sending transaction
+       * @param options Optional transaction parameters (value, gas, nonce, etc.)
+       */
+      async transferOwnership(newOwner: `0x${string}`, options?: {
+        accessList?: import('viem').AccessList;
+        authorizationList?: import('viem').AuthorizationList;
+        chain?: import('viem').Chain | null;
+        dataSuffix?: `0x${string}`;
+        gas?: bigint;
+        gasPrice?: bigint;
+        maxFeePerGas?: bigint;
+        maxPriorityFeePerGas?: bigint;
+        nonce?: number;
+        value?: bigint;
+      }): Promise<void> {
+        return contract.simulate.transferOwnership([newOwner] as const, options) as Promise<void>;
+      },
+      /**
+       * Simulate unpause
+       * Returns gas estimate and result without sending transaction
+       * @param options Optional transaction parameters (value, gas, nonce, etc.)
+       */
+      async unpause(options?: {
+        accessList?: import('viem').AccessList;
+        authorizationList?: import('viem').AuthorizationList;
+        chain?: import('viem').Chain | null;
+        dataSuffix?: `0x${string}`;
+        gas?: bigint;
+        gasPrice?: bigint;
+        maxFeePerGas?: bigint;
+        maxPriorityFeePerGas?: bigint;
+        nonce?: number;
+        value?: bigint;
+      }): Promise<void> {
+        return contract.simulate.unpause(options) as Promise<void>;
+      }
+    };
+  }
+
+  /**
+   * Watch contract events
+   * 
+   * @example
+   * // Watch all Transfer events
+   * const unwatch = contract.watch.Transfer((event) => {
+   *   console.log('Transfer:', event);
+   * });
+   * 
+   * // Stop watching
+   * unwatch();
+   */
+  get watch() {
+    return {
+      /**
+       * Watch AddedBlackList events
+       * @param callback Function to call when event is emitted
+       * @param filter Optional filter for indexed parameters
+       * @returns Unwatch function to stop listening
+       */
+      AddedBlackList: (callback: (event: { _user: `0x${string}` }) => void) => {
+        return this.publicClient.watchContractEvent({
+          address: this.contractAddress,
+          abi: UquidCoinAbi,
+          eventName: 'AddedBlackList',
+          
+          onLogs: (logs: any[]) => {
+            logs.forEach((log: any) => {
+              callback(log.args as any);
+            });
+          },
+        }) as () => void;
+      },
+      /**
+       * Watch Approval events
+       * @param callback Function to call when event is emitted
+       * @param filter Optional filter for indexed parameters
+       * @returns Unwatch function to stop listening
+       */
+      Approval: (callback: (event: { owner: `0x${string}`; spender: `0x${string}`; value: bigint }) => void, filter?: { owner?: `0x${string}` | `0x${string}`[] | null; spender?: `0x${string}` | `0x${string}`[] | null }) => {
+        return this.publicClient.watchContractEvent({
+          address: this.contractAddress,
+          abi: UquidCoinAbi,
+          eventName: 'Approval',
+          args: filter as any,
+          onLogs: (logs: any[]) => {
+            logs.forEach((log: any) => {
+              callback(log.args as any);
+            });
+          },
+        }) as () => void;
+      },
+      /**
+       * Watch Deprecate events
+       * @param callback Function to call when event is emitted
+       * @param filter Optional filter for indexed parameters
+       * @returns Unwatch function to stop listening
+       */
+      Deprecate: (callback: (event: { newAddress: `0x${string}` }) => void) => {
+        return this.publicClient.watchContractEvent({
+          address: this.contractAddress,
+          abi: UquidCoinAbi,
+          eventName: 'Deprecate',
+          
+          onLogs: (logs: any[]) => {
+            logs.forEach((log: any) => {
+              callback(log.args as any);
+            });
+          },
+        }) as () => void;
+      },
+      /**
+       * Watch DestroyedBlackFunds events
+       * @param callback Function to call when event is emitted
+       * @param filter Optional filter for indexed parameters
+       * @returns Unwatch function to stop listening
+       */
+      DestroyedBlackFunds: (callback: (event: { _blackListedUser: `0x${string}`; _balance: bigint }) => void) => {
+        return this.publicClient.watchContractEvent({
+          address: this.contractAddress,
+          abi: UquidCoinAbi,
+          eventName: 'DestroyedBlackFunds',
+          
+          onLogs: (logs: any[]) => {
+            logs.forEach((log: any) => {
+              callback(log.args as any);
+            });
+          },
+        }) as () => void;
+      },
+      /**
+       * Watch Issue events
+       * @param callback Function to call when event is emitted
+       * @param filter Optional filter for indexed parameters
+       * @returns Unwatch function to stop listening
+       */
+      Issue: (callback: (event: { amount: bigint }) => void) => {
+        return this.publicClient.watchContractEvent({
+          address: this.contractAddress,
+          abi: UquidCoinAbi,
+          eventName: 'Issue',
+          
+          onLogs: (logs: any[]) => {
+            logs.forEach((log: any) => {
+              callback(log.args as any);
+            });
+          },
+        }) as () => void;
+      },
+      /**
+       * Watch Params events
+       * @param callback Function to call when event is emitted
+       * @param filter Optional filter for indexed parameters
+       * @returns Unwatch function to stop listening
+       */
+      Params: (callback: (event: { feeBasisPoints: bigint; maxFee: bigint }) => void) => {
+        return this.publicClient.watchContractEvent({
+          address: this.contractAddress,
+          abi: UquidCoinAbi,
+          eventName: 'Params',
+          
+          onLogs: (logs: any[]) => {
+            logs.forEach((log: any) => {
+              callback(log.args as any);
+            });
+          },
+        }) as () => void;
+      },
+      /**
+       * Watch Pause events
+       * @param callback Function to call when event is emitted
+       * @param filter Optional filter for indexed parameters
+       * @returns Unwatch function to stop listening
+       */
+      Pause: (callback: (event: {  }) => void) => {
+        return this.publicClient.watchContractEvent({
+          address: this.contractAddress,
+          abi: UquidCoinAbi,
+          eventName: 'Pause',
+          
+          onLogs: (logs: any[]) => {
+            logs.forEach((log: any) => {
+              callback(log.args as any);
+            });
+          },
+        }) as () => void;
+      },
+      /**
+       * Watch Redeem events
+       * @param callback Function to call when event is emitted
+       * @param filter Optional filter for indexed parameters
+       * @returns Unwatch function to stop listening
+       */
+      Redeem: (callback: (event: { amount: bigint }) => void) => {
+        return this.publicClient.watchContractEvent({
+          address: this.contractAddress,
+          abi: UquidCoinAbi,
+          eventName: 'Redeem',
+          
+          onLogs: (logs: any[]) => {
+            logs.forEach((log: any) => {
+              callback(log.args as any);
+            });
+          },
+        }) as () => void;
+      },
+      /**
+       * Watch RemovedBlackList events
+       * @param callback Function to call when event is emitted
+       * @param filter Optional filter for indexed parameters
+       * @returns Unwatch function to stop listening
+       */
+      RemovedBlackList: (callback: (event: { _user: `0x${string}` }) => void) => {
+        return this.publicClient.watchContractEvent({
+          address: this.contractAddress,
+          abi: UquidCoinAbi,
+          eventName: 'RemovedBlackList',
+          
+          onLogs: (logs: any[]) => {
+            logs.forEach((log: any) => {
+              callback(log.args as any);
+            });
+          },
+        }) as () => void;
+      },
+      /**
+       * Watch Transfer events
+       * @param callback Function to call when event is emitted
+       * @param filter Optional filter for indexed parameters
+       * @returns Unwatch function to stop listening
+       */
+      Transfer: (callback: (event: { from: `0x${string}`; to: `0x${string}`; value: bigint }) => void, filter?: { from?: `0x${string}` | `0x${string}`[] | null; to?: `0x${string}` | `0x${string}`[] | null }) => {
+        return this.publicClient.watchContractEvent({
+          address: this.contractAddress,
+          abi: UquidCoinAbi,
+          eventName: 'Transfer',
+          args: filter as any,
+          onLogs: (logs: any[]) => {
+            logs.forEach((log: any) => {
+              callback(log.args as any);
+            });
+          },
+        }) as () => void;
+      },
+      /**
+       * Watch Unpause events
+       * @param callback Function to call when event is emitted
+       * @param filter Optional filter for indexed parameters
+       * @returns Unwatch function to stop listening
+       */
+      Unpause: (callback: (event: {  }) => void) => {
+        return this.publicClient.watchContractEvent({
+          address: this.contractAddress,
+          abi: UquidCoinAbi,
+          eventName: 'Unpause',
+          
+          onLogs: (logs: any[]) => {
+            logs.forEach((log: any) => {
+              callback(log.args as any);
+            });
+          },
+        }) as () => void;
+      }
+    };
+  }
+}