<h1>Where to start<aclass="headerlink"href="#where-to-start"title="Permalink to this headline">¶</a></h1>
<p>So you want to start experimenting with Corda. Where do you begin? Although Corda is still very early and missing
large chunks of important functionality, this article will hopefully put you on the right place.</p>
<p>An experiment with Corda is started by picking a <em>scenario</em> and then turning it into a <em>demo</em>. It is important to
understand that at this stage in its life, Corda does not have a single unified server that loads everything
dynamically. Instead, Corda provides an object oriented API which is then used by a <em>driver</em> program, with one driver
per scenario. You can see the existing demo apps in action by <aclass="reference internal"href="running-the-demos.html"><spanclass="doc">Running the demos</span></a>.</p>
<p>In future this design will change and there will be a single server that does everything. But for now, there isn’t.</p>
<p>A scenario contains:</p>
<ulclass="simple">
<li>A set of participating nodes and their roles.</li>
<li>Some business process you wish to automate (typically simplified from the real thing).</li>
<li>The smart contracts and protocols that will automate that process.</li>
</ul>
<p>It may also specify a REST/JSON API, but this is optional.</p>
<p>Here’s are two example scenarios included in the box:</p>
<olclass="arabic simple">
<li>Bank A wishes to buy some commercial paper in return for cash. Bank B wants to issue and sell some CP to Bank A.
This is probably the simplest scenario in Corda that still does something interesting. It’s like the buttered
bread of finance.</li>
<li>Bank A and Bank B want to enter into an interest rate swap and evolve it through its lifecycle.</li>
</ol>
<p>The process of implementing a scenario looks like this:</p>
<olclass="arabic simple">
<li>First of all, design your states and transaction types. Read about the <aclass="reference internal"href="data-model.html"><spanclass="doc">Data model</span></a> if you aren’t sure what that
involves.</li>
<li>Now, create a new file in the contracts/src/main directory. You can either any JVM language but we only provide examples
in Java and Kotlin. The file should define your state classes and your contract class, which will define the
allowable state transitions. You can learn how these are constructed by reading the “<aclass="reference internal"href="tutorial-contract.html"><spanclass="doc">Writing a contract</span></a>” tutorial.</li>
<li>It isn’t enough to just define static data and logic that controls what’s allowed. You must also orchestrate the
business process. This is the job of the protocol framework. You can learn how to author these by reading
“<aclass="reference internal"href="protocol-state-machines.html"><spanclass="doc">Protocol state machines</span></a>”.</li>
<li>Once you have created your states, transactions and protocols, you need a way to demonstrate them (outside of the
unit tests, of course). This topic is covered below.</li>
</ol>
<divclass="section"id="the-trader-demo">
<h2>The trader demo<aclass="headerlink"href="#the-trader-demo"title="Permalink to this headline">¶</a></h2>
<p>Until Corda has a unified server that can dynamically load every aspect of an application (i.e. software implementing a scenario),
we have to do a bit of copy/paste wiring ourselves.</p>
<p>The trader demo is a good place to start understanding this, which can be found in src/main/kotlin/demos/TraderDemo.kt</p>
<p>The idea of a driver program is that it starts a node in one of several roles, according to a command line flag. The
driver may step through some pre-programmed scenario automatically or it may register an API to be exported via HTTP.
You would then have to drive the node externally for your demo.</p>
<p>The best way to create your own scenario is not to write a driver from scratch but to copy the existing trader or IRS
demo drivers and then customise them, as much of the code would end up being shared (like for command line parsing).</p>
<p>Things you will want to adjust:</p>
<olclass="arabic simple">
<li>The name of the grouping directory each node role will create its private directory under.</li>
<li>The demo protocols that just wrap the real business process in some kind of fake trading logic.</li>
</ol>
<p>The IRS driver program registers REST APIs, but as this is seriously in flux right now and the APIs will change a lot,
we do not recommend you try this as part of your initial explorations unless you are feeling adventurous.</p>
Built with <ahref="http://sphinx-doc.org/">Sphinx</a> using a <ahref="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <ahref="https://readthedocs.org">Read the Docs</a>.
