@gitmyabi/migrations 0.0.0-stage → 1.0.0

package/README.md

@@ -1,3 +1,108 @@
-# Temporary Holding Version
+# @gitmyabi/migrations
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Auto-generated TypeScript type bindings for **Migrations**
+
+- **Build ID**: `etherscan-migrations-e57d3c97-1794001043665`
+- **Build Number**: 1
+- **Commit**: `fc2b8c2`
+- **Branch**: `etherscan`
+- **Target**: `ethers-v6`
+- **Contracts**: 1
+
+## Installation
+
+```bash
+npm install @gitmyabi/migrations@1.0.0
+```
+
+## Usage
+
+### Class-based API (TypeChain-like)
+
+```typescript
+import { createPublicClient, createWalletClient, http } from 'viem';
+import { mainnet } from 'viem/chains';
+import { YourContract } from '@gitmyabi/migrations';
+
+const publicClient = createPublicClient({ chain: mainnet, transport: http() });
+const walletClient = createWalletClient({ chain: mainnet, transport: http() });
+
+// Create contract instance
+const contract = new YourContract('0x...', { publicClient, walletClient });
+
+// Read functions - call directly like TypeChain!
+const result = await contract.yourMethod(param1, param2);
+
+// Write functions - also call directly!
+const hash = await contract.transfer('0x...', 1000n);
+```
+
+### With viem directly
+
+```typescript
+import { createPublicClient, http } from 'viem';
+import { mainnet } from 'viem/chains';
+import { YourContractAbi } from '@gitmyabi/migrations';
+
+const client = createPublicClient({
+  chain: mainnet,
+  transport: http(),
+});
+
+// Fully typed contract read
+const result = await client.readContract({
+  address: '0x...',
+  abi: YourContractAbi,
+  functionName: 'yourMethod',
+  args: [param1, param2],
+});
+
+// Fully typed contract write
+const hash = await client.writeContract({
+  address: '0x...',
+  abi: YourContractAbi,
+  functionName: 'yourMethod',
+  args: [param1, param2],
+});
+```
+
+### With wagmi
+
+```typescript
+import { useReadContract, useWriteContract } from 'wagmi';
+import { YourContractAbi } from '@gitmyabi/migrations';
+
+function MyComponent() {
+  const { data } = useReadContract({
+    address: '0x...',
+    abi: YourContractAbi,
+    functionName: 'yourMethod',
+    args: [param1, param2],
+  });
+
+  const { writeContract } = useWriteContract();
+  
+  const handleWrite = () => {
+    writeContract({
+      address: '0x...',
+      abi: YourContractAbi,
+      functionName: 'yourMethod',
+      args: [param1, param2],
+    });
+  };
+
+  return <button onClick={handleWrite}>Call Contract</button>;
+}
+```
+
+## Type Safety
+
+This package provides full TypeScript type safety for all contract methods, events, and parameters using viem's type system. All ABIs are exported as `const` assertions for maximum type inference.
+
+## Generated Contracts
+
+This package includes type bindings for 1 contract(s) generated from ABI artifacts.
+
+## License
+
+Apache License 2.0

package/contracts/Migrations.d.ts

@@ -0,0 +1,154 @@
+import type { Address, PublicClient, WalletClient } from 'viem';
+/**
+ * Migrations ABI
+ *
+ * This ABI is typed using viem's type system for full type safety.
+ */
+export declare const MigrationsAbi: readonly [{
+    readonly inputs: readonly [];
+    readonly name: "last_completed_migration";
+    readonly outputs: readonly [{
+        readonly internalType: "uint256";
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [];
+    readonly name: "owner";
+    readonly outputs: readonly [{
+        readonly internalType: "address";
+        readonly name: "";
+        readonly type: "address";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly internalType: "uint256";
+        readonly name: "completed";
+        readonly type: "uint256";
+    }];
+    readonly name: "setCompleted";
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}];
+/**
+ * Type-safe ABI for Migrations
+ */
+export type MigrationsAbi = typeof MigrationsAbi;
+/**
+ * Contract instance type for Migrations
+ */
+export type MigrationsContract = any;
+/**
+ * Migrations 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 { Migrations } from 'Migrations';
+ *
+ * const publicClient = createPublicClient({ chain: mainnet, transport: http() });
+ * const walletClient = createWalletClient({ chain: mainnet, transport: http() });
+ *
+ * const contract = new Migrations('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 declare class Migrations {
+    private contract;
+    private contractAddress;
+    private publicClient;
+    constructor(address: Address, clients: {
+        publicClient: PublicClient;
+        walletClient?: WalletClient;
+    });
+    /**
+     * Get the contract address
+     */
+    get address(): Address;
+    /**
+     * Get the underlying viem contract instance.
+     */
+    getContract(): MigrationsContract;
+    /**
+     * last_completed_migration
+     * view
+     */
+    last_completed_migration(): Promise<bigint>;
+    /**
+     * owner
+     * view
+     */
+    owner(): Promise<`0x${string}`>;
+    /**
+     * setCompleted
+     * nonpayable
+     * @param options Optional transaction parameters (value, gas, nonce, etc.)
+     */
+    setCompleted(completed: 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}`>;
+    /**
+     * 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(): {
+        /**
+         * Simulate setCompleted
+         * Returns gas estimate and result without sending transaction
+         * @param options Optional transaction parameters (value, gas, nonce, etc.)
+         */
+        setCompleted(completed: 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>;
+    };
+    /**
+     * Watch contract events
+     *
+     * Note: This contract has no events, so watch returns an empty object.
+     */
+    get watch(): {};
+}

package/contracts/Migrations.js

@@ -0,0 +1,166 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Migrations = exports.MigrationsAbi = void 0;
+const viem_1 = require("viem");
+/**
+ * Migrations ABI
+ *
+ * This ABI is typed using viem's type system for full type safety.
+ */
+exports.MigrationsAbi = [
+    {
+        "inputs": [],
+        "name": "last_completed_migration",
+        "outputs": [
+            {
+                "internalType": "uint256",
+                "name": "",
+                "type": "uint256"
+            }
+        ],
+        "stateMutability": "view",
+        "type": "function"
+    },
+    {
+        "inputs": [],
+        "name": "owner",
+        "outputs": [
+            {
+                "internalType": "address",
+                "name": "",
+                "type": "address"
+            }
+        ],
+        "stateMutability": "view",
+        "type": "function"
+    },
+    {
+        "inputs": [
+            {
+                "internalType": "uint256",
+                "name": "completed",
+                "type": "uint256"
+            }
+        ],
+        "name": "setCompleted",
+        "outputs": [],
+        "stateMutability": "nonpayable",
+        "type": "function"
+    }
+];
+/**
+ * Migrations 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 { Migrations } from 'Migrations';
+ *
+ * const publicClient = createPublicClient({ chain: mainnet, transport: http() });
+ * const walletClient = createWalletClient({ chain: mainnet, transport: http() });
+ *
+ * const contract = new Migrations('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);
+ * });
+ * ```
+ */
+class Migrations {
+    constructor(address, clients) {
+        this.contractAddress = address;
+        this.publicClient = clients.publicClient;
+        this.contract = (0, viem_1.getContract)({
+            address,
+            abi: exports.MigrationsAbi,
+            client: {
+                public: clients.publicClient,
+                wallet: clients.walletClient,
+            },
+        });
+    }
+    /**
+     * Get the contract address
+     */
+    get address() {
+        return this.contractAddress;
+    }
+    /**
+     * Get the underlying viem contract instance.
+     */
+    getContract() {
+        return this.contract;
+    }
+    /**
+     * last_completed_migration
+     * view
+     */
+    async last_completed_migration() {
+        return this.contract.read.last_completed_migration();
+    }
+    /**
+     * owner
+     * view
+     */
+    async owner() {
+        return this.contract.read.owner();
+    }
+    /**
+     * setCompleted
+     * nonpayable
+     * @param options Optional transaction parameters (value, gas, nonce, etc.)
+     */
+    async setCompleted(completed, options) {
+        if (!this.contract.write) {
+            throw new Error('Wallet client is required for write operations');
+        }
+        return this.contract.write.setCompleted([completed], options);
+    }
+    /**
+     * 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 setCompleted
+             * Returns gas estimate and result without sending transaction
+             * @param options Optional transaction parameters (value, gas, nonce, etc.)
+             */
+            async setCompleted(completed, options) {
+                return contract.simulate.setCompleted([completed], options);
+            }
+        };
+    }
+    /**
+     * Watch contract events
+     *
+     * Note: This contract has no events, so watch returns an empty object.
+     */
+    get watch() {
+        return {};
+    }
+}
+exports.Migrations = Migrations;

package/contracts/Migrations.ts

@@ -0,0 +1,218 @@
+import type { Abi, Address, PublicClient, WalletClient, GetContractReturnType } from 'viem';
+import { getContract } from 'viem';
+
+/**
+ * Migrations ABI
+ * 
+ * This ABI is typed using viem's type system for full type safety.
+ */
+export const MigrationsAbi = [
+  {
+    "inputs": [],
+    "name": "last_completed_migration",
+    "outputs": [
+      {
+        "internalType": "uint256",
+        "name": "",
+        "type": "uint256"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [],
+    "name": "owner",
+    "outputs": [
+      {
+        "internalType": "address",
+        "name": "",
+        "type": "address"
+      }
+    ],
+    "stateMutability": "view",
+    "type": "function"
+  },
+  {
+    "inputs": [
+      {
+        "internalType": "uint256",
+        "name": "completed",
+        "type": "uint256"
+      }
+    ],
+    "name": "setCompleted",
+    "outputs": [],
+    "stateMutability": "nonpayable",
+    "type": "function"
+  }
+] as const satisfies Abi;
+
+/**
+ * Type-safe ABI for Migrations
+ */
+export type MigrationsAbi = typeof MigrationsAbi;
+
+/**
+ * Contract instance type for Migrations
+ */
+// Use any for contract type to avoid complex viem type issues
+// The runtime behavior is type-safe through viem's ABI typing
+export type MigrationsContract = any;
+
+/**
+ * Migrations 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 { Migrations } from 'Migrations';
+ * 
+ * const publicClient = createPublicClient({ chain: mainnet, transport: http() });
+ * const walletClient = createWalletClient({ chain: mainnet, transport: http() });
+ * 
+ * const contract = new Migrations('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 Migrations {
+  private contract: MigrationsContract;
+  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: MigrationsAbi,
+      client: {
+        public: clients.publicClient,
+        wallet: clients.walletClient,
+      },
+    });
+  }
+
+  /**
+   * Get the contract address
+   */
+  get address(): Address {
+    return this.contractAddress;
+  }
+
+  /**
+   * Get the underlying viem contract instance.
+   */
+  getContract(): MigrationsContract {
+    return this.contract;
+  }
+
+  /**
+   * last_completed_migration
+   * view
+   */
+  async last_completed_migration(): Promise<bigint> {
+    return this.contract.read.last_completed_migration() as Promise<bigint>;
+  }
+
+  /**
+   * owner
+   * view
+   */
+  async owner(): Promise<`0x${string}`> {
+    return this.contract.read.owner() as Promise<`0x${string}`>;
+  }
+
+  /**
+   * setCompleted
+   * nonpayable
+   * @param options Optional transaction parameters (value, gas, nonce, etc.)
+   */
+  async setCompleted(completed: 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.setCompleted([completed] 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 setCompleted
+       * Returns gas estimate and result without sending transaction
+       * @param options Optional transaction parameters (value, gas, nonce, etc.)
+       */
+      async setCompleted(completed: 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.setCompleted([completed] as const, options) as Promise<void>;
+      }
+    };
+  }
+
+  /**
+   * Watch contract events
+   * 
+   * Note: This contract has no events, so watch returns an empty object.
+   */
+  get watch() {
+    return {};
+  }
+}

package/contracts/index.d.ts

@@ -0,0 +1,2 @@
+export { MigrationsAbi, Migrations } from './Migrations';
+export type { MigrationsAbi as MigrationsAbiType, MigrationsContract } from './Migrations';

package/contracts/index.js

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

package/contracts/index.ts

@@ -0,0 +1,3 @@
+// Auto-generated exports for all contracts
+export { MigrationsAbi, Migrations } from './Migrations';
+export type { MigrationsAbi as MigrationsAbiType, MigrationsContract } from './Migrations';

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

@@ -1,6 +1,43 @@
 {
   "name": "@gitmyabi/migrations",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.0.0",
+  "description": "Auto-generated TypeScript type bindings for Migrations (build etherscan-migrations-e57d3c97-1794001043665, commit fc2b8c2, 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": "Apache-2.0",
+  "dependencies": {
+    "viem": "^2.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/etherscan/migrations"
+  },
+  "branch": "etherscan",
+  "shortHash": "fc2b8c2"
 }