Skip to content

Commit

Permalink
fix(links) : create version 0.30.1
Browse files Browse the repository at this point in the history
Signed-off-by: Dan Selman <[email protected]>
Signed-off-by: Vinyl-Davyl <[email protected]>
  • Loading branch information
dselman authored and Vinyl-Davyl committed Apr 23, 2024
1 parent 6723b98 commit 76c4bb1
Show file tree
Hide file tree
Showing 19 changed files with 2,682 additions and 0 deletions.
59 changes: 59 additions & 0 deletions website/versioned_docs/version-0.30.1/accordproject-faq.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
---
id: version-0.30.1-accordproject-faq
title: FAQ
original_id: accordproject-faq
---
## Accord Project Frequently asked Questions

### What is a "Smart Contract" in the Accord Project?

A “smart” legal contract is a legally binding agreement that is digital and able to connect its terms and the performance of its obligations to external sources of data and software systems. The benefit is to enable a wide variety of efficiencies, automation, and real time visibility for lawyers, businesses, nonprofits, and government. The potential applications of smart legal contracts are limitless. Although the operation of smart legal contracts may be enhanced by using blockchain technology, a blockchain is not necessary, smart legal contracts can operate using traditional software systems without blockchain. A central goal of Accord Project technology is to be blockchain agnostic.

A smart legal contract consists of natural language text with certain parts (e.g. clauses, sections) of the agreement constructed as machine executable components. The libraries provided by the Accord Project enable a document to be:

* Structured as machine readable data objects; and
* Executed on, or integrated with, external systems (e.g. to initiate a payment or update an invoice)

While the Accord Project technology is targeted at the development of smart legal contracts, the open source codebase may also be used to develop other forms of machine-readable and executable documentation.

### How is an Accord Project "Smart Contract" different from "Smart Contracts" on the blockchain?

Accord Project Smart legal contracts should not be confused with so-called blockchain “smart contracts”, which are scripts that necesarily operate on a blockchain. On the blockchain a smart contract is often written in a specific language like solidity that executes and operates on the blockchain. It lives in a closed world. An Accord Project Smart Contract contains text based template that integrates with a data model and the Ergo language. The three components are integrated into a whole. Using Ergo an Accord Project Smart contract can communicate with other systems, it can send and receive data, it can perform calculations and it can interact with a blockchain.

### What benefits do Smart Legal Contracts provide?

Contractual agreements sit at the heart of any organization, governing relationships with employees, shareholders, customers, suppliers, financiers, and more. Yet contracts today are not capable of being efficiently managed as the valuable assets they are. Currently contracts exist as static text documents stored in cloud storage services, dated contract management systems, or even email inboxes. Often these documents are Word files or PDFs that can only be interpreted by humans. A smart legal contract, by contrast, can be interpreted by machines.

Smart Legal Contracts can be easily searched, analyzed, queried, and understood. By associating a data model to a contract, it is possible to extract a host of valuable data about a contract or draft a series of contracts from existing data points (i.e., variables and their values).

The data model is used to ensure that all of the necessary data is present in the contract, and that this data is valid. In addition, it provides the necessary structure to enable contracts to "come alive" by adding executable logic.

The result is a contract that is:


* Searchable
* Analyzable
* Real-time
* Integrated

Consequently, contracts are transformed from business liabilities in constant need of management to assets capable of providing real business intelligence and value. A Smart Contract contains a data model so that the data is part of the contract and not something held in an external system. The logical operations of the contract are also part of the contract. The contract can update itself and react to the outside world. Rather than being stored in filing cabinet it is a living breathing process.

### What is the Accord Project and what is its purpose?

The Accord Project is a non-profit, member-driven organization that builds open source code and documentation for smart legal contracts for use by transactional attorneys, business and finance professionals, and other contract users. Open source means that anyone can use and contribute to the code and documentation and use it in their own software applications and systems free of charge.

The purpose of the Accord Project is to establish and maintain a common and consistent legal and technical foundation for smart legal contracts. The Accord Project is organized into working groups focused on various use cases for Smart Contracts. The specific working groups are assisted by the Technology Working Group, which builds the underlying open source code and specifications to codify the knowledge of the transactional working groups. More details about the internal governance of the Accord Project are available [here](https://github.com/accordproject/governance).


### How can I get involved?

The Accord Project Community is developing several working groups focusing on different applications of smart contracts. The working groups have frequent calls and use the Accord Project’s Discord group chat application (join by clicking [here](https://discord.com/invite/Zm99SKhhtA)) for discussion. The dates, dial-in instructions, and agendas for the working groups are all listed in the Project’s public calendar and typically also in working group’s respective Discord channels.

A primary purpose of the working groups is to develop a universally accessible and widely used open source library of modular, smart legal contracts, smart templates and models that reflect input from the community. Smart legal contract templates are built according to the Project’s [Cicero Specification](https://github.com/accordproject/cicero).

Members can provide feedback into the templates and models relevant to a particular working group. You can immediately start contributing smart legal contract templates and models by using the Accord Project’s [Template Studio](https://studio.accordproject.org/).

The Accord Project has developed an easy-to-use programming language for building and executing smart legal contracts called Ergo. The goals of Ergo are to be accessible and usable by non-technical professionals, portable across, and compatible with, a variety of environments such as SaaS platforms and different blockchains, and meeting security, safety, and other requirements.

You can use the Accord Project’s [Template Studio](https://studio.accordproject.org/) to create and test your smart legal contracts.

78 changes: 78 additions & 0 deletions website/versioned_docs/version-0.30.1/accordproject-slc.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,78 @@
---
id: version-0.30.1-accordproject-slc
title: Smart Legal Contracts
original_id: accordproject-slc
---

A Smart Legal Contract is a human-readable _and_ machine-readable agreement that is digital, consisting of natural language and computable components.

The human-readable nature of the document ensures that signatories, lawyers, contracting parties and others are able to understand the contract.

The machine-readable nature of the document enables it to be interpreted and executed by computers, making the document "smart".

Contracts drafted with Accord Project can contain both traditional and machine-readable clauses. For example, a Smart Legal Contract may include a smart payment clause while all of the other provisions of the contract (Definitions, Jurisdiction clause, Force Majeure clause, ...) are being documented solely in regular natural language text.

A Smart Legal Contract is a general term to refer to two compatible, architectural forms of contract:
- Machine-Readable Contracts, which tie legal text to data
- Machine-Executable Contracts, which tie legal text to data and executable code

### Machine-Readable Contracts

By combining Text and a data, a clause or contract becomes machine-readable.

For instance, the clause below for a [fixed rate loan](https://templates.accordproject.org/[email protected]) includes natural language text coupled with variables. Together, these variables refer to some data for the clause and correspond to the 'deal points':

```tem
## Fixed rate loan
This is a *fixed interest* loan to the amount of {{loanAmount}}
at the yearly interest rate of {{rate}}%
with a loan term of {{loanDuration}},
and monthly payments of {{monthlyPayment}}.
```

To make sense of the data, a _Data Model_, expressed in the Concerto schema language, defines the variables for the template and their associated Data Types:

```ergo
o Double loanAmount // loanAmount is a floating-point number
o Double rate // rate is a floating-point number
o Integer loanDuration // loanDuration is an integer
o Double monthlyPayment // monthlyPayment is a floating-point number
```

The Data Types allow a computer to validate values inserted into each of the `{{variable}}` placeholders (e.g., `2.5` is a valid `{{rate}}` but `January` isn't). In other words, the Data Model lets a computer make sense of the structure of (and data in) the clause. To learn more about Data Types see [Concerto Modeling](model-concerto.md).

The clause data (the 'deal points') can then be capture as a machine-readable representation:

```js
{
"$class": "org.accordproject.interests.TemplateModel",
"clauseId": "cec0a194-cd45-42f7-ab3e-7a673978602a",
"loanAmount": 100000.0,
"rate": 2.5,
"loanDuration": 15
"monthlyPayment": 667.0
}
```

The values entered into the template text are associated with the name of the variable e.g. `{{rate}} = 2.5%`. This provides the structure for understanding the clause and its contents.

### Machine-Executable Contracts

By adding Logic to a machine-readable clause or contract in the form of expressions - much like in a spreadsheet - the contract is able to execute operations based upon data included in the contract.

For instance, the clause below is a variant of the earlier [fixed rate loan](https://templates.accordproject.org/[email protected]). While it is consistent with the previous one, the `{{monthlyPayment}}` variable is replaced with an [Ergo](logic-ergo.md) expression `monthlyPaymentFormula(loanAmount,rate,loanDuration)` which calculates the monthly interest rate based upon the values of the other variables: `{{loanAmount}}`, `{{rate}}`, and `{{loanDuration}}`. To learn more about contract Logic see [Ergo Logic](logic-ergo.md).

```tem
## Fixed rate loan
This is a *fixed interest* loan to the amount of {{loanAmount}}
at a yearly interest rate of {{rate}}%
with a loan term of {{loanDuration}},
and monthly payments of {{% monthlyPaymentFormula(loanAmount,rate,loanDuration) %}}.
```

This is a simple example of the benefits of Machine-Executable contract, here adding logic to ensure that the value of the `{{monthlyPayment}}` in the text is always consistent with the other variables in the clause. In this example, we display the contract text using the underlying [Markup](markup-preliminaries.md) format, instead of the rich-text output that would be found in [editor tools](started-resources.md#ecosystem-tools) and PDF outputs.

More complex examples, (e.g., how to add post-signature logic which responds to data sent to the contract or which triggers operations on external systems) can be found in the rest of this documentation.

Loading

0 comments on commit 76c4bb1

Please sign in to comment.