Build npm Package: near-contract-parser - Smart Contract ABI Tools

Overview

Create a package that can parse NEAR smart contracts, extract their interfaces, and generate TypeScript types for type-safe contract interactions.

Why This Matters

Working with NEAR contracts often involves guessing method signatures. This tool brings type safety to contract interactions.

Technical Requirements

Core Features

import { parseContract, generateTypes } from 'near-contract-parser';

// Parse a contract's WASM to extract interface
const abi = await parseContract({
  contractId: "token.near",
  // or from local WASM file
  wasmPath: "./contract.wasm"
});

// Generate TypeScript types
const types = generateTypes(abi);
// Creates: interface TokenContract { ... }

// Use generated types
import { TokenContract } from "./generated/token";
const contract = new Contract<TokenContract>(account, "token.near");
await contract.ft_transfer({ receiver_id: "bob.near", amount: "100" });
// ^ Fully typed!

Capabilities

1. WASM parsing - Extract method signatures from compiled contracts
2. Type inference - Infer argument and return types
3. TypeScript generation - Create .d.ts files
4. CLI tool - npx near-contract-parser generate token.near
5. Known patterns - Pre-built types for NEP standards

Deliverables

1. npm package with library and CLI
2. WASM parser for method extraction
3. TypeScript generator
4. Pre-built types for common contracts
5. Documentation

Budget: 8 NEAR