Best way to set up canton test fixtures?

I’d like to run some tests that programmatically manipulate a canton instance. I heard a rumor the other day that we have a canton sandbox - I imagine this is what I actually want, but maybe not. What are the options/what sounds like a sensible approach?

The Daml Sandbox is now Canton based. The sandbox is just a specific configuration with 1 participant and 1 domain with in-memory storage. Otherwise, it’s a vanilla Canton system.

Generally, for integration testing of Canton, we use our “scalatest” based testing that allows us to run “integration tests” as unittests. These environments give you the equivalent of the Canton Console in your IDE and you can run a series of command as a “unittest”.

digital-asset/canton/blob/c6035298c302500f1c4bbe8f39145ea0dddb5168/community/app/src/test/scala/com/digitalasset/canton/integration/tests/ExampleIntegrationTest.scala#L77-L83

      
        

            
class SimplePingExampleIntegrationTest
            
    extends ExampleIntegrationTest(simpleTopology / "simple-topology.conf") {
            

            
  "run simple-ping.canton successfully" in { implicit env =>
            
    runScript(simpleTopology / "simple-ping.canton")(env.environment)
            
  }
            
}
        
      
    

The env object therein gives you a full console environment if you add import env._.

The test tooling is available in our open source drop as well, but the majority of the tests are still in the enterprise bundle.

this looks perfect, thanks!