@gitmyabi/storage 1.0.0

package/contracts/Storage_json.ts

@@ -0,0 +1,517 @@
+import type { Abi, Address, PublicClient, WalletClient, GetContractReturnType } from 'viem';
+import { getContract } from 'viem';
+
+/**
+ * Storage_json ABI
+ * 
+ * This ABI is typed using viem's type system for full type safety.
+ */
+export const Storage_jsonAbi = [
+  {
+    "inputs": [],
+    "name": "InvalidOwner",
+    "type": "error"
+  },
+  {
+    "inputs": [],
+    "name": "InvalidSessionId",
+    "type": "error"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "validator",
+        "type": "address"
+      }
+    ],
+    "name": "InvalidValidator",
+    "type": "error"
+  },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": false,
+        "internalType": "uint256",
+        "name": "utilisedNonce",
+        "type": "uint256"
+      }
+    ],
+    "name": "NonceConsumed",
+    "type": "event"
+  },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": false,
+        "internalType": "uint256",
+        "name": "id",
+        "type": "uint256"
+      }
+    ],
+    "name": "SessionRevoked",
+    "type": "event"
+  },
+  {
+    "anonymous": false,
+    "inputs": [
+      {
+        "indexed": false,
+        "internalType": "address",
+        "name": "validator",
+        "type": "address"
+      },
+      {
+        "indexed": false,
+        "internalType": "bool",
+        "name": "status",
+        "type": "bool"
+      }
+    ],
+    "name": "ValidatorStatusUpdated",
+    "type": "event"
+  },
+  {
+    "inputs": [],
+    "name": "getNonce",
+    "outputs": [
+      {
+        "internalType": "uint256",
+        "name": "",
+        "type": "uint256"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [],
+    "name": "getOwner",
+    "outputs": [
+      {
+        "internalType": "address",
+        "name": "",
+        "type": "address"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "validator",
+        "type": "address"
+      }
+    ],
+    "name": "readAndUpdateNonce",
+    "outputs": [
+      {
+        "internalType": "uint256",
+        "name": "",
+        "type": "uint256"
+      }
+    ],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "uint256",
+        "name": "id",
+        "type": "uint256"
+      }
+    ],
+    "name": "revokeSession",
+    "outputs": [],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "validator",
+        "type": "address"
+      },
+      {
+        "internalType": "bool",
+        "name": "isValid",
+        "type": "bool"
+      }
+    ],
+    "name": "setValidatorStatus",
+    "outputs": [],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "uint256",
+        "name": "id",
+        "type": "uint256"
+      },
+      {
+        "internalType": "address",
+        "name": "validator",
+        "type": "address"
+      }
+    ],
+    "name": "validateSession",
+    "outputs": [],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "address",
+        "name": "validator",
+        "type": "address"
+      }
+    ],
+    "name": "validateValidator",
+    "outputs": [],
+    "stateMutability": "view",
+    "type": "function"
+  }
+] as const satisfies Abi;
+
+/**
+ * Type-safe ABI for Storage_json
+ */
+export type Storage_jsonAbi = typeof Storage_jsonAbi;
+
+/**
+ * Contract instance type for Storage_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 Storage_jsonContract = any;
+
+/**
+ * Storage_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 { Storage_json } from 'Storage_json';
+ * 
+ * const publicClient = createPublicClient({ chain: mainnet, transport: http() });
+ * const walletClient = createWalletClient({ chain: mainnet, transport: http() });
+ * 
+ * const contract = new Storage_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 Storage_json {
+  private contract: Storage_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: Storage_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(): Storage_jsonContract {
+    return this.contract;
+  }
+
+  /**
+   * getNonce
+   * view
+   */
+  async getNonce(): Promise<bigint> {
+    return this.contract.read.getNonce() as Promise<bigint>;
+  }
+
+  /**
+   * getOwner
+   * view
+   */
+  async getOwner(): Promise<`0x${string}`> {
+    return this.contract.read.getOwner() as Promise<`0x${string}`>;
+  }
+
+  /**
+   * validateSession
+   * view
+   */
+  async validateSession(id: bigint, validator: `0x${string}`): Promise<void> {
+    return this.contract.read.validateSession([id, validator] as const) as Promise<void>;
+  }
+
+  /**
+   * validateValidator
+   * view
+   */
+  async validateValidator(validator: `0x${string}`): Promise<void> {
+    return this.contract.read.validateValidator([validator] as const) as Promise<void>;
+  }
+
+  /**
+   * readAndUpdateNonce
+   * nonpayable
+   * @param options Optional transaction parameters (value, gas, nonce, etc.)
+   */
+  async readAndUpdateNonce(validator: `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.readAndUpdateNonce([validator] as const, options) as Promise<`0x${string}`>;
+  }
+
+  /**
+   * revokeSession
+   * nonpayable
+   * @param options Optional transaction parameters (value, gas, nonce, etc.)
+   */
+  async revokeSession(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.revokeSession([id] as const, options) as Promise<`0x${string}`>;
+  }
+
+  /**
+   * setValidatorStatus
+   * nonpayable
+   * @param options Optional transaction parameters (value, gas, nonce, etc.)
+   */
+  async setValidatorStatus(validator: `0x${string}`, isValid: 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.setValidatorStatus([validator, isValid] as const, 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 readAndUpdateNonce
+       * Returns gas estimate and result without sending transaction
+       * @param options Optional transaction parameters (value, gas, nonce, etc.)
+       */
+      async readAndUpdateNonce(validator: `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<bigint> {
+        return contract.simulate.readAndUpdateNonce([validator] as const, options) as Promise<bigint>;
+      },
+      /**
+       * Simulate revokeSession
+       * Returns gas estimate and result without sending transaction
+       * @param options Optional transaction parameters (value, gas, nonce, etc.)
+       */
+      async revokeSession(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.revokeSession([id] as const, options) as Promise<void>;
+      },
+      /**
+       * Simulate setValidatorStatus
+       * Returns gas estimate and result without sending transaction
+       * @param options Optional transaction parameters (value, gas, nonce, etc.)
+       */
+      async setValidatorStatus(validator: `0x${string}`, isValid: 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.setValidatorStatus([validator, isValid] as const, 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 NonceConsumed events
+       * @param callback Function to call when event is emitted
+       * @param filter Optional filter for indexed parameters
+       * @returns Unwatch function to stop listening
+       */
+      NonceConsumed: (callback: (event: { utilisedNonce: bigint }) => void) => {
+        return this.publicClient.watchContractEvent({
+          address: this.contractAddress,
+          abi: Storage_jsonAbi,
+          eventName: 'NonceConsumed',
+          
+          onLogs: (logs: any[]) => {
+            logs.forEach((log: any) => {
+              callback(log.args as any);
+            });
+          },
+        }) as () => void;
+      },
+      /**
+       * Watch SessionRevoked events
+       * @param callback Function to call when event is emitted
+       * @param filter Optional filter for indexed parameters
+       * @returns Unwatch function to stop listening
+       */
+      SessionRevoked: (callback: (event: { id: bigint }) => void) => {
+        return this.publicClient.watchContractEvent({
+          address: this.contractAddress,
+          abi: Storage_jsonAbi,
+          eventName: 'SessionRevoked',
+          
+          onLogs: (logs: any[]) => {
+            logs.forEach((log: any) => {
+              callback(log.args as any);
+            });
+          },
+        }) as () => void;
+      },
+      /**
+       * Watch ValidatorStatusUpdated events
+       * @param callback Function to call when event is emitted
+       * @param filter Optional filter for indexed parameters
+       * @returns Unwatch function to stop listening
+       */
+      ValidatorStatusUpdated: (callback: (event: { validator: `0x${string}`; status: boolean }) => void) => {
+        return this.publicClient.watchContractEvent({
+          address: this.contractAddress,
+          abi: Storage_jsonAbi,
+          eventName: 'ValidatorStatusUpdated',
+          
+          onLogs: (logs: any[]) => {
+            logs.forEach((log: any) => {
+              callback(log.args as any);
+            });
+          },
+        }) as () => void;
+      }
+    };
+  }
+}

package/contracts/index.d.ts

@@ -0,0 +1,2 @@
+export { Storage_jsonAbi, Storage_json } from './Storage_json';
+export type { Storage_jsonAbi as Storage_jsonAbiType, Storage_jsonContract } from './Storage_json';

package/contracts/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Storage_json = exports.Storage_jsonAbi = void 0;
+// Auto-generated exports for all contracts
+var Storage_json_1 = require("./Storage_json");
+Object.defineProperty(exports, "Storage_jsonAbi", { enumerable: true, get: function () { return Storage_json_1.Storage_jsonAbi; } });
+Object.defineProperty(exports, "Storage_json", { enumerable: true, get: function () { return Storage_json_1.Storage_json; } });

package/contracts/index.ts

@@ -0,0 +1,3 @@
+// Auto-generated exports for all contracts
+export { Storage_jsonAbi, Storage_json } from './Storage_json';
+export type { Storage_jsonAbi as Storage_jsonAbiType, Storage_jsonContract } from './Storage_json';

package/index.d.ts

@@ -0,0 +1 @@
+export * from './contracts';

package/index.js

@@ -0,0 +1,19 @@
+"use strict";
+// Auto-generated TypeScript type bindings
+// This file exports all generated contract types
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./contracts"), exports);

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@gitmyabi/storage",
+  "version": "1.0.0",
+  "description": "Auto-generated TypeScript type bindings for Storage (build etherscan-storage-eb2864a0-1785467151251, commit 4759d25, branch etherscan)",
+  "main": "./index.js",
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./index.js",
+      "require": "./index.js",
+      "types": "./index.d.ts"
+    },
+    "./contracts": {
+      "import": "./contracts/index.js",
+      "require": "./contracts/index.js",
+      "types": "./contracts/index.d.ts"
+    }
+  },
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "contracts"
+  ],
+  "keywords": [
+    "ethereum",
+    "smart-contracts",
+    "viem",
+    "wagmi",
+    "typescript",
+    "abi",
+    "ethers-v6"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "viem": "^2.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/etherscan/storage"
+  },
+  "branch": "etherscan",
+  "shortHash": "4759d25"
+}