dojo-integration-test

Automate end-to-end integration testing for Dojo Cairo contracts with local Katana and Torii.

37|54|Updated Sep 11, 2023
One-click install
npx skills add https://github.com/dojoengine/dojo.js --skill dojo-integration-test
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dojo-integration-test
Source: https://github.com/dojoengine/dojo.js/tree/main/.claude/skills/dojo-integration-test
Command: npx skills add https://github.com/dojoengine/dojo.js --skill dojo-integration-test

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates end-to-end integration testing for Dojo Cairo contracts by provisioning a complete local development stack and enabling reproducible test workflows.

Core Features & Use Cases

  • Local environment provisioning for Dojo development (Katana, Torii, and the Cairo contract project)
  • Migration, deployment, and interaction of contracts in a repeatable test harness
  • End-to-end verification of contract behavior via world state inspection and GraphQL/GRPC queries

Quick Start

Start with an existing Dojo project and run the integration test workflow to spin up Katana, migrate contracts, launch Torii, and verify test results.

Frequently Asked Questions about dojo-integration-test

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run integration tests for Dojo Cairo contracts locally?

Running local Dojo integration tests requires provisioning a complete development stack including Katana, Torii, and the Cairo contract project. The test workflow automates setup, migration, deployment, and runtime interaction for reproducible end-to-end verification.

What prerequisites do I need to set up a local Dojo testing environment?

Setting up a local Dojo testing environment requires installing asdf plugins for sozo, katana, torii, and scarb. You also need an existing Dojo project with the correct structure and available ports to run the local development stack components.

How can I verify Dojo contract behavior using world state inspection?

Verify Dojo contract behavior by provisioning the local stack, migrating contracts, and launching Torii. This enables end-to-end verification through world state inspection and querying the runtime state via GraphQL and GRPC endpoints.

Does this Dojo integration testing workflow handle contract deployment and migration?

Yes, the Dojo integration testing workflow automates contract migration and deployment. It provisions the local development stack to ensure contracts are deployed repeatably before executing runtime interaction and verification tests.

What should I check if my local Katana or Torii setup for Dojo testing is not working?

If your local Dojo testing stack is not working, verify that the required ports are available and not conflicting. The guided startup sequence performs port checks and validates that all prerequisite tools like Katana and Torii are running correctly.

When do I need end-to-end integration testing for Dojo development?

You need end-to-end integration testing for Dojo development when automating reproducible test workflows for Cairo contracts. It provisions a local stack to test deployment, migration, and runtime interaction scenarios comprehensively.