import * as React from 'react'; import { hydrate, render } from 'react-dom'; import * as Loadable from 'react-loadable'; import { context } from 'ts/context/trace'; import { Base } from 'ts/components/base'; import { Breakout } from 'ts/components/breakout'; import { CallToAction } from 'ts/components/call_to_action'; import { Code } from 'ts/components/code'; import { Content } from 'ts/components/content'; import { ContentBlock } from 'ts/components/content-block'; import { Hero } from 'ts/components/hero'; import { InlineCode } from 'ts/components/inline-code'; import { List, ListItem } from 'ts/components/list'; import { TabBlock, Tabs } from 'ts/components/tabs'; import { Trace as TraceComponent } from 'ts/components/trace'; const Animation = Loadable({ loader: () => System.import(/* webpackChunkName: 'trace-animation' */ 'ts/components/animations/trace'), loading: () =>
, delay: 1000, render(loadable: { TraceAnimation: any }): React.ReactNode { const Component = loadable.TraceAnimation; return ; }, }); const Trace: React.StatelessComponent<{}> = () => ( Use{' '} Geth {' '} as a backing node. We recommend using our{' '} Devnet Docker container {' '} which sets up a Geth node for testing purposes.{' '} Ganache support is a work in progress. Understand and use{' '} web3-provider-engine . npm install @0x/sol-trace --save

Sol-trace is a subprovider that needs to be prepended to your{' '} provider engine . Depending on your project setup, you will need to use a specific ArtifactAdapter. Sol-trace ships with the SolCompilerArtifactAdapter for use with{' '} Sol-compiler {' '} and TruffleArtifactAdapter for use with the{' '} Truffle framework {' '} (Also see our{' '} Truffle example project {' '} for a complete walk-through). You can also write your own and support any artifact format.

{`import { SolCompilerArtifactAdapter } from '@0x/sol-trace'; // Both artifactsDir and contractsDir are optional and will be fetched from compiler.json if not passed in const artifactAdapter = new SolCompilerArtifactAdapter(artifactsDir, contractsDir);`} {`import { TruffleArtifactAdapter } from '@0x/sol-trace'; const projectRoot = '.'; const solcVersion = '0.5.0'; const artifactAdapter = new TruffleArtifactAdapter(projectRoot, solcVersion);`} {`import { AbstractArtifactAdapter } from '@0x/sol-trace'; class YourCustomArtifactsAdapter extends AbstractArtifactAdapter {...}; const artifactAdapter = new YourCustomArtifactsAdapter(...);`}

Now that we have an artifactAdapter, we can create a{' '} revertTraceSubprovider and append it to our provider engine.

{`import { ProviderEngine, RpcSubprovider } from 'web3-provider-engine'; import { RevertTraceSubprovider } from '@0x/sol-trace'; const defaultFromAddress = "..."; // Some ethereum address with test funds const revertTraceSubprovider = new RevertTraceSubprovider(artifactAdapter, defaultFromAddress); const providerEngine = new ProviderEngine(); providerEngine.addProvider(revertTraceSubprovider); providerEngine.addProvider(new RpcSubprovider({rpcUrl: 'http://localhost:8545'})); providerEngine.start();`}

Stack traces will now be printed whenever your contracts revert!

); const root = document.getElementById('app'); if (root.hasChildNodes()) { hydrate(, root); } else { render(, root); }