Foundry Integration

Use Voltaire with Foundry for testing and deployment

Looking for Contributors — This Skill needs implementation. If you’re interested in building Foundry integration for Voltaire, open an issue or submit a PR.

Foundry Integration

This Skill will provide seamless integration between Voltaire and Foundry for Solidity development.

Planned Features

• Forge Test Helpers — Use Voltaire primitives in Forge tests via FFI
• Anvil Integration — Connect Voltaire providers to local Anvil nodes
• Cast Compatibility — Share transaction building logic between Cast and Voltaire
• Script Interop — Use Voltaire for complex off-chain logic in Forge scripts
• ABI Sync — Automatic ABI import from Foundry’s out/ directory

Example Usage (Proposed)

import { foundry } from "./skills/foundry/index.js";
import * as Address from "@voltaire/primitives/Address";
import * as Transaction from "@voltaire/primitives/Transaction";

// Connect to local Anvil
const anvil = foundry.anvil({ port: 8545 });

// Load deployed contract from Foundry artifacts
const contract = await foundry.loadContract("out/MyContract.sol/MyContract.json");

// Build transaction using Voltaire
const tx = Transaction.from({
  to: Address.from(contract.address),
  data: contract.interface.encodeFunctionData("mint", [100n]),
});

// Execute and get traces
const result = await anvil.call(tx, { trace: true });

Contributing

To implement this Skill:

1. Fork the Voltaire repository
2. Create examples/foundry/ directory
3. Implement the integration following Skills Philosophy
4. Add tests and documentation
5. Submit a PR

Key implementation areas:

• Anvil JSON-RPC client using Voltaire’s provider primitives
• Foundry artifact parser for ABI/bytecode extraction
• FFI bridge for using Voltaire in Forge tests
• Script execution context for off-chain computation