Corda is an open source blockchain project, designed for business from the start. Only Corda allows you to build interoperable blockchain networks that transact in strict privacy. Corda's smart contract technology allows businesses to transact directly, with value.
Go to file
josecoll 8c3b9ac589 Vault Query API design (#522)
* Added queryBy(QueryCriteria) Vault API and Junit tests.

* Minor fix following rebase.

* Spit out Vault Query tests into separate source file.

* WIP

* Enable composition of QueryCriteria specifications.
Additional JUnit test cases to validate API.

* Added Deprecating annotations.
Added QueryCriteria for set of contractStateTypes

* Minor tweaks and additional JUnit test cases (chain of linear id)

* Added Java Junit tests and QueryCriteria builder support.

* Added API documentation (including coding snippets and examples).

* Added @JvmOverloads to QueryCriteria classes for easy of use from Java.

* Refactored QueryCriteria API to use composition via sealed data classes.

* Enable infix notation.

* Fixed typo.

* Clarified future work to enforce DB level permissioning.

* Moved PageSpec and Order from QueryCriteria to become parameters of Query itself.

* Moved PageSpec and Order from QueryCriteria to become parameters of Query itself.

* TokenType now specified as set of <Class> (was non extensible enum).

* Exposed new Vault Query API functions via RPC.

* Fixed compiler error in java test.

* Addressed a couple of minor PR review scomments from MH.

* Major updates following PR discussion and recommendations.

* All pagination and sorting arguments are optional (and constructed with sensible defaults).
Added Java helper functions for queryBy and trackBy interfaces.
Added Java trackBy unit tests.
Miscellaneous cleanup.

* Added Generic Index schema mapping and query support.

* Query criteria referencing Party now references a String (until Identity framework built out).
Added participants attribute to general query criteria.

* Fleshed our IndexCriteria including PR recommendation to define column aliases for index mappings.

* Removed all directly exposed API dependencies on requery.

* Updated documentation.

* Provide sensible defaults for all Query arguments.
Add RPC Java helpers and increase range of Vault Service helpers.

* Further improvements (upgrading notes) and updates to documentation.

* RST documentation updates.

* Updates to address RP latest set of review comments.

* Updates to address MH latest set of review comments.

* Updated to highlight use of VaultIndexQueryCriteria to directly reference a JPA-annotated entity (versus the indirect, explicitly mapped attribute to GenericIndexSchema approach)

* Aesthetic updates requested by MH

* Reverted Indexing approach: removed all references to VaultIndexedQueryCriteria and GenericVaultIndexSchemaV1 scheme.

* Final clean-up and minor updates prior to merge.

* Fixed compiler warnings (except deprecation warnings)

* Reverted all changes to Vault Schemas (except simple illustrative VaultLinearState used in VaultQueryTests)

* Reverted all changes to Vault Schemas (except simple illustrative VaultLinearState used in VaultQueryTests)

* Commented out @Deprecated annotations (as a hedge against us releasing M12 with the work half-done)

* Renamed RPC JavaHelper functions as RPCDispatcher does not allow more than one method with same name.
2017-05-05 15:14:43 +01:00
.idea AMQP serialisation: Part 1 (#581) 2017-05-05 12:14:02 +01:00
buildSrc Upgraded both guava and guava-testlib to 21.0 and made sure they share the same version variable 2017-03-24 17:17:36 +00:00
client Support for multi-sig schemes. ECC (K1/R1) and EdDSA are fully supported. (#599) 2017-05-04 18:19:00 +01:00
config Interim patch introducing X500Names 2017-05-03 10:46:03 +01:00
core Vault Query API design (#522) 2017-05-05 15:14:43 +01:00
docs Vault Query API design (#522) 2017-05-05 15:14:43 +01:00
experimental Use assert methods from test framework. Don't use Java assert. (#625) 2017-05-03 17:32:30 +01:00
finance Vault Query API design (#522) 2017-05-05 15:14:43 +01:00
gradle/wrapper Upgrade to Kotlin 1.0.7 and Gradle 3.4.1 (#402) 2017-03-22 12:05:49 +00:00
gradle-plugins Extract common name from legal name to determine path 2017-04-28 16:40:48 +01:00
lib Upgrade Quasar to 0.7.6 and fix an exception handling bug in SMM that it revealed (if an exception was thrown immediately on protocol startup we let it leak instead of capturing it in the future. 2016-08-17 14:43:45 +01:00
node Vault Query API design (#522) 2017-05-05 15:14:43 +01:00
node-api Merge pull request #582 from corda/shams-flow-counterpartymarker-cleanup 2017-04-26 09:40:48 +01:00
node-schemas Vault Query API design (#522) 2017-05-05 15:14:43 +01:00
samples Support for multi-sig schemes. ECC (K1/R1) and EdDSA are fully supported. (#599) 2017-05-04 18:19:00 +01:00
test-utils Add support for re-sending session messages. This is useful when talking to a distributed service, e.g. notary – if one of the nodes go down in the middle of a session, the session will be re-established with a different node (round-robin order). 2017-05-05 10:08:53 +01:00
tools Explorer x500names (#631) 2017-05-05 14:00:55 +01:00
verifier Include log4j2.xml into application jars only. This allows applications to use their own log4j2.xml files, if required. (#635) 2017-05-05 13:12:36 +01:00
webserver Include log4j2.xml into application jars only. This allows applications to use their own log4j2.xml files, if required. (#635) 2017-05-05 13:12:36 +01:00
.gitignore AMQP serialisation: Part 1 (#581) 2017-05-05 12:14:02 +01:00
build.gradle Include log4j2.xml into application jars only. This allows applications to use their own log4j2.xml files, if required. (#635) 2017-05-05 13:12:36 +01:00
constants.properties Extract common name from legal name to determine path 2017-04-28 16:40:48 +01:00
CONTRIBUTING.md Addressed some review comments about the license and readmes. 2016-11-22 11:56:46 +00:00
gradle.properties Enable Kotlin incremental compilation in Gradle 2017-01-06 16:39:01 +01:00
gradlew Upgrade to Kotlin 1.0.7 and Gradle 3.4.1 (#402) 2017-03-22 12:05:49 +00:00
gradlew.bat Upgrade to Kotlin 1.0.7 and Gradle 3.4.1 (#402) 2017-03-22 12:05:49 +00:00
LICENSE Update LICENSE 2017-03-06 15:33:29 +01:00
README.md Update production readiness warning (#505) 2017-04-04 16:58:24 +01:00
settings.gradle Moved webserver to root project. 2017-03-30 17:34:32 +01:00
TRADEMARK Amended wording of trademark notice per advice from legal counsel. 2016-11-29 21:11:09 +00:00

Corda

Corda

Corda is a decentralised database system in which nodes trust each other as little as possible.

Features

  • A P2P network of nodes
  • Smart contracts
  • Flow framework
  • "Notary" infrastructure to validate uniqueness of transactions
  • Written as a platform for distributed apps called CorDapps
  • Written in Kotlin, targeting the JVM

Read our full and planned feature list here.

Getting started

Firstly, read the Getting started documentation.

Next, use the following guides to set up your dev environment:

  • If you are on Windows use this getting started guide which also explains through how to run the sample apps.

  • Alternatively if you are on Mac/Linux, watch this brief Webinar which walks through getting Corda, installing it, building it, running nodes and opening projects in IntelliJ.

After the above, watching the following webinars will give you a great introduction to Corda:

Webinar 1 Introduction to Corda

Richard Brown, R3 Chief Technology Officer, explains Corda's unique architecture, the only distributed ledger platform designed by and for the financial industry's unique requirements. You may want to read the Corda non-technical whitepaper as pre-reading for this session.

Webinar 2 Corda Developers Tutorial

Roger Willis, R3 Developer Relations Lead, provides an overview of Corda from a developers perspective and guidance on how to start building CorDapps. You may want to view Webinar 1 - Introduction to Corda as preparation for this session. NB. This was recorded for the M5 release.

Building on Corda

To build your own CorDapps:

  1. Clone the CorDapp Template repository
  2. Read the README (IMPORTANT!)
  3. Read the Writing a CorDapp documentation

To look at the Corda source and run some sample applications:

  1. Clone this repository
  2. To run some sample CorDapps, read the running the demos documentation
  3. Start hacking and contribute!

Development State

Corda is under active development and is maturing rapidly. We are targeting production-readiness in 2017. The API will continue to evolve throughout 2017; backwards compatibility not assured until version 1.0.

Pull requests, experiments, and contributions are encouraged and welcomed.

Background

The project is supported by R3, a financial industry consortium, which is why it contains some code for financial use cases and why the documentation focuses on finance. The goal is to use it to construct a global ledger, simplifying finance and reducing the overheads of banking. But it is run as an open source project and the basic technology of a peer-to-peer decentralised database may be useful for many different projects.

Contributing

Please read here.

License

Apache 2.0

Acknowledgements

YourKit

YourKit supports open source projects with its full-featured Java Profiler.

YourKit, LLC is the creator of YourKit Java Profiler and YourKit .NET Profiler, innovative and intelligent tools for profiling Java and .NET applications.