@gitmyabi/vlns 0.0.0-stage → 1.0.0

package/contracts/VLNS_json.ts

@@ -0,0 +1,1716 @@
+import type { Abi, Address, PublicClient, WalletClient, GetContractReturnType } from 'viem';
+import { getContract } from 'viem';
+
+/**
+ * VLNS_json ABI
+ * 
+ * This ABI is typed using viem's type system for full type safety.
+ */
+export const VLNS_jsonAbi = [
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "deployer",
+        "type": "address"
+      },
+      {
+        "internalType": "address",
+        "name": "defaultRoyaltyReceiver",
+        "type": "address"
+      }
+    ],
+    "stateMutability": "nonpayable",
+    "type": "constructor"
+  },
+  {
+    "inputs": [],
+    "name": "AlreadyLinked",
+    "type": "error"
+  },
+  {
+    "inputs": [],
+    "name": "CannotLink",
+    "type": "error"
+  },
+  {
+    "inputs": [],
+    "name": "FnSelectorNotRecognized",
+    "type": "error"
+  },
+  {
+    "inputs": [],
+    "name": "IsFinalized",
+    "type": "error"
+  },
+  {
+    "inputs": [],
+    "name": "NotAuthorized",
+    "type": "error"
+  },
+  {
+    "inputs": [],
+    "name": "NotLinked",
+    "type": "error"
+  },
+  {
+    "inputs": [],
+    "name": "SenderNotBase",
+    "type": "error"
+  },
+  {
+    "inputs": [],
+    "name": "SenderNotDeployer",
+    "type": "error"
+  },
+  {
+    "inputs": [],
+    "name": "TransferToNonERC721ReceiverImplementer",
+    "type": "error"
+  },
+  {
+    "inputs": [],
+    "name": "ValueNotAccepted",
+    "type": "error"
+  },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "owner",
+        "type": "address"
+      },
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "account",
+        "type": "address"
+      },
+      {
+        "indexed": true,
+        "internalType": "uint256",
+        "name": "id",
+        "type": "uint256"
+      }
+    ],
+    "name": "Approval",
+    "type": "event"
+  },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "owner",
+        "type": "address"
+      },
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "operator",
+        "type": "address"
+      },
+      {
+        "indexed": false,
+        "internalType": "bool",
+        "name": "isApproved",
+        "type": "bool"
+      }
+    ],
+    "name": "ApprovalForAll",
+    "type": "event"
+  },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "receiver",
+        "type": "address"
+      },
+      {
+        "indexed": false,
+        "internalType": "uint96",
+        "name": "feeNumerator",
+        "type": "uint96"
+      }
+    ],
+    "name": "DefaultRoyaltyUpdated",
+    "type": "event"
+  },
+  {
+    "anonymous": false,
+    "inputs": [],
+    "name": "MirrorFinalized",
+    "type": "event"
+  },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "oldOwner",
+        "type": "address"
+      },
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "newOwner",
+        "type": "address"
+      }
+    ],
+    "name": "OwnershipTransferred",
+    "type": "event"
+  },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": true,
+        "internalType": "bytes32",
+        "name": "role",
+        "type": "bytes32"
+      },
+      {
+        "indexed": true,
+        "internalType": "bytes32",
+        "name": "previousAdminRole",
+        "type": "bytes32"
+      },
+      {
+        "indexed": true,
+        "internalType": "bytes32",
+        "name": "newAdminRole",
+        "type": "bytes32"
+      }
+    ],
+    "name": "RoleAdminChanged",
+    "type": "event"
+  },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": true,
+        "internalType": "bytes32",
+        "name": "role",
+        "type": "bytes32"
+      },
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "account",
+        "type": "address"
+      },
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "sender",
+        "type": "address"
+      }
+    ],
+    "name": "RoleGranted",
+    "type": "event"
+  },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": true,
+        "internalType": "bytes32",
+        "name": "role",
+        "type": "bytes32"
+      },
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "account",
+        "type": "address"
+      },
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "sender",
+        "type": "address"
+      }
+    ],
+    "name": "RoleRevoked",
+    "type": "event"
+  },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "from",
+        "type": "address"
+      },
+      {
+        "indexed": true,
+        "internalType": "address",
+        "name": "to",
+        "type": "address"
+      },
+      {
+        "indexed": true,
+        "internalType": "uint256",
+        "name": "id",
+        "type": "uint256"
+      }
+    ],
+    "name": "Transfer",
+    "type": "event"
+  },
+  {
+    "stateMutability": "payable",
+    "type": "fallback"
+  },
+  {
+    "inputs": [],
+    "name": "ADMIN_ROLE",
+    "outputs": [
+      {
+        "internalType": "bytes32",
+        "name": "",
+        "type": "bytes32"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [],
+    "name": "DEFAULT_ADMIN_ROLE",
+    "outputs": [
+      {
+        "internalType": "bytes32",
+        "name": "",
+        "type": "bytes32"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "spender",
+        "type": "address"
+      },
+      {
+        "internalType": "uint256",
+        "name": "id",
+        "type": "uint256"
+      }
+    ],
+    "name": "approve",
+    "outputs": [],
+    "stateMutability": "payable",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "nftOwner",
+        "type": "address"
+      }
+    ],
+    "name": "balanceOf",
+    "outputs": [
+      {
+        "internalType": "uint256",
+        "name": "",
+        "type": "uint256"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [],
+    "name": "baseERC20",
+    "outputs": [
+      {
+        "internalType": "address",
+        "name": "base",
+        "type": "address"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [],
+    "name": "finalize",
+    "outputs": [],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
+  {
+    "inputs": [],
+    "name": "finalized",
+    "outputs": [
+      {
+        "internalType": "bool",
+        "name": "",
+        "type": "bool"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "uint256",
+        "name": "id",
+        "type": "uint256"
+      }
+    ],
+    "name": "getApproved",
+    "outputs": [
+      {
+        "internalType": "address",
+        "name": "",
+        "type": "address"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [],
+    "name": "getDefaultRoyaltyRate",
+    "outputs": [
+      {
+        "internalType": "uint96",
+        "name": "",
+        "type": "uint96"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "bytes32",
+        "name": "role",
+        "type": "bytes32"
+      }
+    ],
+    "name": "getRoleAdmin",
+    "outputs": [
+      {
+        "internalType": "bytes32",
+        "name": "",
+        "type": "bytes32"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "bytes32",
+        "name": "role",
+        "type": "bytes32"
+      },
+      {
+        "internalType": "address",
+        "name": "account",
+        "type": "address"
+      }
+    ],
+    "name": "grantRole",
+    "outputs": [],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "bytes32",
+        "name": "role",
+        "type": "bytes32"
+      },
+      {
+        "internalType": "address",
+        "name": "account",
+        "type": "address"
+      }
+    ],
+    "name": "hasRole",
+    "outputs": [
+      {
+        "internalType": "bool",
+        "name": "",
+        "type": "bool"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "nftOwner",
+        "type": "address"
+      },
+      {
+        "internalType": "address",
+        "name": "operator",
+        "type": "address"
+      }
+    ],
+    "name": "isApprovedForAll",
+    "outputs": [
+      {
+        "internalType": "bool",
+        "name": "",
+        "type": "bool"
+      }
+    ],
+    "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": [
+      {
+        "internalType": "uint256",
+        "name": "id",
+        "type": "uint256"
+      }
+    ],
+    "name": "ownerAt",
+    "outputs": [
+      {
+        "internalType": "address",
+        "name": "",
+        "type": "address"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "uint256",
+        "name": "id",
+        "type": "uint256"
+      }
+    ],
+    "name": "ownerOf",
+    "outputs": [
+      {
+        "internalType": "address",
+        "name": "",
+        "type": "address"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [],
+    "name": "pullOwner",
+    "outputs": [
+      {
+        "internalType": "bool",
+        "name": "",
+        "type": "bool"
+      }
+    ],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "bytes32",
+        "name": "role",
+        "type": "bytes32"
+      },
+      {
+        "internalType": "address",
+        "name": "account",
+        "type": "address"
+      }
+    ],
+    "name": "renounceRole",
+    "outputs": [],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "bytes32",
+        "name": "role",
+        "type": "bytes32"
+      },
+      {
+        "internalType": "address",
+        "name": "account",
+        "type": "address"
+      }
+    ],
+    "name": "revokeRole",
+    "outputs": [],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "uint256",
+        "name": "tokenId",
+        "type": "uint256"
+      },
+      {
+        "internalType": "uint256",
+        "name": "salePrice",
+        "type": "uint256"
+      }
+    ],
+    "name": "royaltyInfo",
+    "outputs": [
+      {
+        "internalType": "address",
+        "name": "",
+        "type": "address"
+      },
+      {
+        "internalType": "uint256",
+        "name": "",
+        "type": "uint256"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "from",
+        "type": "address"
+      },
+      {
+        "internalType": "address",
+        "name": "to",
+        "type": "address"
+      },
+      {
+        "internalType": "uint256",
+        "name": "id",
+        "type": "uint256"
+      }
+    ],
+    "name": "safeTransferFrom",
+    "outputs": [],
+    "stateMutability": "payable",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "from",
+        "type": "address"
+      },
+      {
+        "internalType": "address",
+        "name": "to",
+        "type": "address"
+      },
+      {
+        "internalType": "uint256",
+        "name": "id",
+        "type": "uint256"
+      },
+      {
+        "internalType": "bytes",
+        "name": "data",
+        "type": "bytes"
+      }
+    ],
+    "name": "safeTransferFrom",
+    "outputs": [],
+    "stateMutability": "payable",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "operator",
+        "type": "address"
+      },
+      {
+        "internalType": "bool",
+        "name": "approved",
+        "type": "bool"
+      }
+    ],
+    "name": "setApprovalForAll",
+    "outputs": [],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "receiver",
+        "type": "address"
+      },
+      {
+        "internalType": "uint96",
+        "name": "feeNumerator",
+        "type": "uint96"
+      }
+    ],
+    "name": "setDefaultRoyalty",
+    "outputs": [],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "bytes4",
+        "name": "interfaceId",
+        "type": "bytes4"
+      }
+    ],
+    "name": "supportsInterface",
+    "outputs": [
+      {
+        "internalType": "bool",
+        "name": "",
+        "type": "bool"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [],
+    "name": "symbol",
+    "outputs": [
+      {
+        "internalType": "string",
+        "name": "",
+        "type": "string"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "uint256",
+        "name": "id",
+        "type": "uint256"
+      }
+    ],
+    "name": "tokenURI",
+    "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": "from",
+        "type": "address"
+      },
+      {
+        "internalType": "address",
+        "name": "to",
+        "type": "address"
+      },
+      {
+        "internalType": "uint256",
+        "name": "id",
+        "type": "uint256"
+      }
+    ],
+    "name": "transferFrom",
+    "outputs": [],
+    "stateMutability": "payable",
+    "type": "function"
+  },
+  {
+    "inputs": [],
+    "name": "withdrawETH",
+    "outputs": [],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
+  {
+    "stateMutability": "payable",
+    "type": "receive"
+  }
+] as const satisfies Abi;
+
+/**
+ * Type-safe ABI for VLNS_json
+ */
+export type VLNS_jsonAbi = typeof VLNS_jsonAbi;
+
+/**
+ * Contract instance type for VLNS_json
+ */
+// Use any for contract type to avoid complex viem type issues
+// The runtime behavior is type-safe through viem's ABI typing
+export type VLNS_jsonContract = any;
+
+/**
+ * VLNS_json 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 { VLNS_json } from 'VLNS_json';
+ * 
+ * const publicClient = createPublicClient({ chain: mainnet, transport: http() });
+ * const walletClient = createWalletClient({ chain: mainnet, transport: http() });
+ * 
+ * const contract = new VLNS_json('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 VLNS_json {
+  private contract: VLNS_jsonContract;
+  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: VLNS_jsonAbi,
+      client: {
+        public: clients.publicClient,
+        wallet: clients.walletClient,
+      },
+    });
+  }
+
+  /**
+   * Get the contract address
+   */
+  get address(): Address {
+    return this.contractAddress;
+  }
+
+  /**
+   * Get the underlying viem contract instance
+   */
+  getContract(): VLNS_jsonContract {
+    return this.contract;
+  }
+
+  /**
+   * ADMIN_ROLE
+   * view
+   */
+  async ADMIN_ROLE(): Promise<`0x${string}`> {
+    return this.contract.read.ADMIN_ROLE() as Promise<`0x${string}`>;
+  }
+
+  /**
+   * DEFAULT_ADMIN_ROLE
+   * view
+   */
+  async DEFAULT_ADMIN_ROLE(): Promise<`0x${string}`> {
+    return this.contract.read.DEFAULT_ADMIN_ROLE() as Promise<`0x${string}`>;
+  }
+
+  /**
+   * balanceOf
+   * view
+   */
+  async balanceOf(nftOwner: `0x${string}`): Promise<bigint> {
+    return this.contract.read.balanceOf([nftOwner] as const) as Promise<bigint>;
+  }
+
+  /**
+   * baseERC20
+   * view
+   */
+  async baseERC20(): Promise<`0x${string}`> {
+    return this.contract.read.baseERC20() as Promise<`0x${string}`>;
+  }
+
+  /**
+   * finalized
+   * view
+   */
+  async finalized(): Promise<boolean> {
+    return this.contract.read.finalized() as Promise<boolean>;
+  }
+
+  /**
+   * getApproved
+   * view
+   */
+  async getApproved(id: bigint): Promise<`0x${string}`> {
+    return this.contract.read.getApproved([id] as const) as Promise<`0x${string}`>;
+  }
+
+  /**
+   * getDefaultRoyaltyRate
+   * view
+   */
+  async getDefaultRoyaltyRate(): Promise<bigint> {
+    return this.contract.read.getDefaultRoyaltyRate() as Promise<bigint>;
+  }
+
+  /**
+   * getRoleAdmin
+   * view
+   */
+  async getRoleAdmin(role: `0x${string}`): Promise<`0x${string}`> {
+    return this.contract.read.getRoleAdmin([role] as const) as Promise<`0x${string}`>;
+  }
+
+  /**
+   * hasRole
+   * view
+   */
+  async hasRole(role: `0x${string}`, account: `0x${string}`): Promise<boolean> {
+    return this.contract.read.hasRole([role, account] as const) as Promise<boolean>;
+  }
+
+  /**
+   * isApprovedForAll
+   * view
+   */
+  async isApprovedForAll(nftOwner: `0x${string}`, operator: `0x${string}`): Promise<boolean> {
+    return this.contract.read.isApprovedForAll([nftOwner, operator] as const) as Promise<boolean>;
+  }
+
+  /**
+   * 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}`>;
+  }
+
+  /**
+   * ownerAt
+   * view
+   */
+  async ownerAt(id: bigint): Promise<`0x${string}`> {
+    return this.contract.read.ownerAt([id] as const) as Promise<`0x${string}`>;
+  }
+
+  /**
+   * ownerOf
+   * view
+   */
+  async ownerOf(id: bigint): Promise<`0x${string}`> {
+    return this.contract.read.ownerOf([id] as const) as Promise<`0x${string}`>;
+  }
+
+  /**
+   * royaltyInfo
+   * view
+   */
+  async royaltyInfo(tokenId: bigint, salePrice: bigint): Promise<[`0x${string}`, bigint]> {
+    return this.contract.read.royaltyInfo([tokenId, salePrice] as const) as Promise<[`0x${string}`, bigint]>;
+  }
+
+  /**
+   * supportsInterface
+   * view
+   */
+  async supportsInterface(interfaceId: `0x${string}`): Promise<boolean> {
+    return this.contract.read.supportsInterface([interfaceId] as const) as Promise<boolean>;
+  }
+
+  /**
+   * symbol
+   * view
+   */
+  async symbol(): Promise<string> {
+    return this.contract.read.symbol() as Promise<string>;
+  }
+
+  /**
+   * tokenURI
+   * view
+   */
+  async tokenURI(id: bigint): Promise<string> {
+    return this.contract.read.tokenURI([id] as const) as Promise<string>;
+  }
+
+  /**
+   * totalSupply
+   * view
+   */
+  async totalSupply(): Promise<bigint> {
+    return this.contract.read.totalSupply() as Promise<bigint>;
+  }
+
+  /**
+   * approve
+   * payable
+   * @param options Optional transaction parameters (value, gas, nonce, etc.)
+   */
+  async approve(spender: `0x${string}`, id: 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, id] as const, options) as Promise<`0x${string}`>;
+  }
+
+  /**
+   * finalize
+   * nonpayable
+   * @param options Optional transaction parameters (value, gas, nonce, etc.)
+   */
+  async finalize(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.finalize(options) as Promise<`0x${string}`>;
+  }
+
+  /**
+   * grantRole
+   * nonpayable
+   * @param options Optional transaction parameters (value, gas, nonce, etc.)
+   */
+  async grantRole(role: `0x${string}`, account: `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.grantRole([role, account] as const, options) as Promise<`0x${string}`>;
+  }
+
+  /**
+   * pullOwner
+   * nonpayable
+   * @param options Optional transaction parameters (value, gas, nonce, etc.)
+   */
+  async pullOwner(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.pullOwner(options) as Promise<`0x${string}`>;
+  }
+
+  /**
+   * renounceRole
+   * nonpayable
+   * @param options Optional transaction parameters (value, gas, nonce, etc.)
+   */
+  async renounceRole(role: `0x${string}`, account: `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.renounceRole([role, account] as const, options) as Promise<`0x${string}`>;
+  }
+
+  /**
+   * revokeRole
+   * nonpayable
+   * @param options Optional transaction parameters (value, gas, nonce, etc.)
+   */
+  async revokeRole(role: `0x${string}`, account: `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.revokeRole([role, account] as const, options) as Promise<`0x${string}`>;
+  }
+
+  async safeTransferFrom(from: `0x${string}`, to: `0x${string}`, id: 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}`>;
+  async safeTransferFrom(from: `0x${string}`, to: `0x${string}`, id: bigint, data: `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}`>;
+  async safeTransferFrom(...args: any[]): Promise<`0x${string}`> {
+    if (!this.contract.write) {
+      throw new Error('Wallet client is required for write operations');
+    }
+    return this.contract.write.safeTransferFrom(args as any) as Promise<`0x${string}`>;
+  }
+
+  /**
+   * setApprovalForAll
+   * nonpayable
+   * @param options Optional transaction parameters (value, gas, nonce, etc.)
+   */
+  async setApprovalForAll(operator: `0x${string}`, approved: boolean, 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.setApprovalForAll([operator, approved] as const, options) as Promise<`0x${string}`>;
+  }
+
+  /**
+   * setDefaultRoyalty
+   * nonpayable
+   * @param options Optional transaction parameters (value, gas, nonce, etc.)
+   */
+  async setDefaultRoyalty(receiver: `0x${string}`, feeNumerator: 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.setDefaultRoyalty([receiver, feeNumerator] as const, options) as Promise<`0x${string}`>;
+  }
+
+  /**
+   * transferFrom
+   * payable
+   * @param options Optional transaction parameters (value, gas, nonce, etc.)
+   */
+  async transferFrom(from: `0x${string}`, to: `0x${string}`, id: 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, id] as const, options) as Promise<`0x${string}`>;
+  }
+
+  /**
+   * withdrawETH
+   * nonpayable
+   * @param options Optional transaction parameters (value, gas, nonce, etc.)
+   */
+  async withdrawETH(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.withdrawETH(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 approve
+       * Returns gas estimate and result without sending transaction
+       * @param options Optional transaction parameters (value, gas, nonce, etc.)
+       */
+      async approve(spender: `0x${string}`, id: 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, id] as const, options) as Promise<void>;
+      },
+      /**
+       * Simulate finalize
+       * Returns gas estimate and result without sending transaction
+       * @param options Optional transaction parameters (value, gas, nonce, etc.)
+       */
+      async finalize(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.finalize(options) as Promise<void>;
+      },
+      /**
+       * Simulate grantRole
+       * Returns gas estimate and result without sending transaction
+       * @param options Optional transaction parameters (value, gas, nonce, etc.)
+       */
+      async grantRole(role: `0x${string}`, account: `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.grantRole([role, account] as const, options) as Promise<void>;
+      },
+      /**
+       * Simulate pullOwner
+       * Returns gas estimate and result without sending transaction
+       * @param options Optional transaction parameters (value, gas, nonce, etc.)
+       */
+      async pullOwner(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<boolean> {
+        return contract.simulate.pullOwner(options) as Promise<boolean>;
+      },
+      /**
+       * Simulate renounceRole
+       * Returns gas estimate and result without sending transaction
+       * @param options Optional transaction parameters (value, gas, nonce, etc.)
+       */
+      async renounceRole(role: `0x${string}`, account: `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.renounceRole([role, account] as const, options) as Promise<void>;
+      },
+      /**
+       * Simulate revokeRole
+       * Returns gas estimate and result without sending transaction
+       * @param options Optional transaction parameters (value, gas, nonce, etc.)
+       */
+      async revokeRole(role: `0x${string}`, account: `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.revokeRole([role, account] as const, options) as Promise<void>;
+      },
+      /**
+       * Simulate safeTransferFrom
+       * Returns gas estimate and result without sending transaction
+       * Supports multiple overloads: (address, address, uint256), (address, address, uint256, bytes)
+       * @param options Optional transaction parameters (value, gas, nonce, etc.)
+       */
+      async safeTransferFrom(...args: any[]): Promise<any> {
+        return contract.simulate.safeTransferFrom(args as any) as Promise<any>;
+      },
+      /**
+       * Simulate setApprovalForAll
+       * Returns gas estimate and result without sending transaction
+       * @param options Optional transaction parameters (value, gas, nonce, etc.)
+       */
+      async setApprovalForAll(operator: `0x${string}`, approved: boolean, 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.setApprovalForAll([operator, approved] as const, options) as Promise<void>;
+      },
+      /**
+       * Simulate setDefaultRoyalty
+       * Returns gas estimate and result without sending transaction
+       * @param options Optional transaction parameters (value, gas, nonce, etc.)
+       */
+      async setDefaultRoyalty(receiver: `0x${string}`, feeNumerator: 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.setDefaultRoyalty([receiver, feeNumerator] 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}`, id: 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, id] as const, options) as Promise<void>;
+      },
+      /**
+       * Simulate withdrawETH
+       * Returns gas estimate and result without sending transaction
+       * @param options Optional transaction parameters (value, gas, nonce, etc.)
+       */
+      async withdrawETH(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.withdrawETH(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 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}`; account: `0x${string}`; id: bigint }) => void, filter?: { owner: `0x${string}`; account: `0x${string}`; id: bigint }) => {
+        return this.publicClient.watchContractEvent({
+          address: this.contractAddress,
+          abi: VLNS_jsonAbi,
+          eventName: 'Approval',
+          args: filter,
+          onLogs: (logs: any[]) => {
+            logs.forEach((log: any) => {
+              callback(log.args as any);
+            });
+          },
+        }) as () => void;
+      },
+      /**
+       * Watch ApprovalForAll events
+       * @param callback Function to call when event is emitted
+       * @param filter Optional filter for indexed parameters
+       * @returns Unwatch function to stop listening
+       */
+      ApprovalForAll: (callback: (event: { owner: `0x${string}`; operator: `0x${string}`; isApproved: boolean }) => void, filter?: { owner: `0x${string}`; operator: `0x${string}` }) => {
+        return this.publicClient.watchContractEvent({
+          address: this.contractAddress,
+          abi: VLNS_jsonAbi,
+          eventName: 'ApprovalForAll',
+          args: filter,
+          onLogs: (logs: any[]) => {
+            logs.forEach((log: any) => {
+              callback(log.args as any);
+            });
+          },
+        }) as () => void;
+      },
+      /**
+       * Watch DefaultRoyaltyUpdated events
+       * @param callback Function to call when event is emitted
+       * @param filter Optional filter for indexed parameters
+       * @returns Unwatch function to stop listening
+       */
+      DefaultRoyaltyUpdated: (callback: (event: { receiver: `0x${string}`; feeNumerator: bigint }) => void, filter?: { receiver: `0x${string}` }) => {
+        return this.publicClient.watchContractEvent({
+          address: this.contractAddress,
+          abi: VLNS_jsonAbi,
+          eventName: 'DefaultRoyaltyUpdated',
+          args: filter,
+          onLogs: (logs: any[]) => {
+            logs.forEach((log: any) => {
+              callback(log.args as any);
+            });
+          },
+        }) as () => void;
+      },
+      /**
+       * Watch MirrorFinalized events
+       * @param callback Function to call when event is emitted
+       * @param filter Optional filter for indexed parameters
+       * @returns Unwatch function to stop listening
+       */
+      MirrorFinalized: (callback: (event: {  }) => void) => {
+        return this.publicClient.watchContractEvent({
+          address: this.contractAddress,
+          abi: VLNS_jsonAbi,
+          eventName: 'MirrorFinalized',
+          
+          onLogs: (logs: any[]) => {
+            logs.forEach((log: any) => {
+              callback(log.args as any);
+            });
+          },
+        }) as () => void;
+      },
+      /**
+       * Watch OwnershipTransferred events
+       * @param callback Function to call when event is emitted
+       * @param filter Optional filter for indexed parameters
+       * @returns Unwatch function to stop listening
+       */
+      OwnershipTransferred: (callback: (event: { oldOwner: `0x${string}`; newOwner: `0x${string}` }) => void, filter?: { oldOwner: `0x${string}`; newOwner: `0x${string}` }) => {
+        return this.publicClient.watchContractEvent({
+          address: this.contractAddress,
+          abi: VLNS_jsonAbi,
+          eventName: 'OwnershipTransferred',
+          args: filter,
+          onLogs: (logs: any[]) => {
+            logs.forEach((log: any) => {
+              callback(log.args as any);
+            });
+          },
+        }) as () => void;
+      },
+      /**
+       * Watch RoleAdminChanged events
+       * @param callback Function to call when event is emitted
+       * @param filter Optional filter for indexed parameters
+       * @returns Unwatch function to stop listening
+       */
+      RoleAdminChanged: (callback: (event: { role: `0x${string}`; previousAdminRole: `0x${string}`; newAdminRole: `0x${string}` }) => void, filter?: { role: `0x${string}`; previousAdminRole: `0x${string}`; newAdminRole: `0x${string}` }) => {
+        return this.publicClient.watchContractEvent({
+          address: this.contractAddress,
+          abi: VLNS_jsonAbi,
+          eventName: 'RoleAdminChanged',
+          args: filter,
+          onLogs: (logs: any[]) => {
+            logs.forEach((log: any) => {
+              callback(log.args as any);
+            });
+          },
+        }) as () => void;
+      },
+      /**
+       * Watch RoleGranted events
+       * @param callback Function to call when event is emitted
+       * @param filter Optional filter for indexed parameters
+       * @returns Unwatch function to stop listening
+       */
+      RoleGranted: (callback: (event: { role: `0x${string}`; account: `0x${string}`; sender: `0x${string}` }) => void, filter?: { role: `0x${string}`; account: `0x${string}`; sender: `0x${string}` }) => {
+        return this.publicClient.watchContractEvent({
+          address: this.contractAddress,
+          abi: VLNS_jsonAbi,
+          eventName: 'RoleGranted',
+          args: filter,
+          onLogs: (logs: any[]) => {
+            logs.forEach((log: any) => {
+              callback(log.args as any);
+            });
+          },
+        }) as () => void;
+      },
+      /**
+       * Watch RoleRevoked events
+       * @param callback Function to call when event is emitted
+       * @param filter Optional filter for indexed parameters
+       * @returns Unwatch function to stop listening
+       */
+      RoleRevoked: (callback: (event: { role: `0x${string}`; account: `0x${string}`; sender: `0x${string}` }) => void, filter?: { role: `0x${string}`; account: `0x${string}`; sender: `0x${string}` }) => {
+        return this.publicClient.watchContractEvent({
+          address: this.contractAddress,
+          abi: VLNS_jsonAbi,
+          eventName: 'RoleRevoked',
+          args: filter,
+          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}`; id: bigint }) => void, filter?: { from: `0x${string}`; to: `0x${string}`; id: bigint }) => {
+        return this.publicClient.watchContractEvent({
+          address: this.contractAddress,
+          abi: VLNS_jsonAbi,
+          eventName: 'Transfer',
+          args: filter,
+          onLogs: (logs: any[]) => {
+            logs.forEach((log: any) => {
+              callback(log.args as any);
+            });
+          },
+        }) as () => void;
+      }
+    };
+  }
+}