Testing with Tangle

How to test your blueprint with Tangle

This guide describes practical options for testing blueprints against Tangle.

Prerequisites

You will typically want:

• A local EVM RPC (for example, anvil)
• A wallet key for deployments/testing
• The blueprint runner / blueprint manager toolchain (for running off-chain services)

Option 1: Use Testnet/Mainnet Deployments (Recommended)

If you’re testing integration and don’t need to modify protocol contracts, use the published deployment RPC and contract addresses:

• Endpoints and Integration

This is the fastest way to validate blueprint registration, service activation, job calls/results, and fee flows.

Option 2: Local EVM Network

For local development, run a local EVM node and deploy the protocol contracts into it. A common setup is:

anvil

Then deploy protocol contracts using the official deployment tooling in the protocol repository (or connect to a test deployment if one is available).

Option 3: Unit Testing the Off-Chain Logic

Many blueprints can be tested without a chain by unit-testing their job handlers and runtime components. Use this when you want fast iteration on business logic without end-to-end protocol integration.