# ACoconut - Lockup Contract

## Use Case Description

The system allows sellers to create new lockup issuance, and allows buyers to engage the existing lockup issuance.

## Actors

* Seller, who is the asset seller of the lockup. Usually the Foundation who wants to stabilize the market price of the token asset;
* Buyer, who is the asset purchaser of the lockup. Usually the token investor;
* Timer Oracle, who is an external timer service provider that provides timing information.

## Precondition

* Financial Service Providers have created the lockup instruments using the NUTS protocol;

## Process Flow

![](https://3859064823-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LoaA4YYVTuDERPqi-LD%2F-LoaAlnLdaTbWWV9XcCX%2F-LoaApAFMrDuoLVU79OT%2Fnuts-design-diagrams-lockup-contract-process-flow.jpg?generation=1568303708559662\&alt=media)

### Main Process Flow

* Seller creates new issuance of lockup instrument;
* Seller deposits the bonus token to the lockup issuance;
* Buyers engages the lockup issuance;
* Buyers deposits the principal token to the lockup issuance;
* When the lockup ends, the buyers can retrieve both the principals and the bonus token.

### Alternative Process Flow

* If seller does not deposit the bonus token in time, the issuance becomes unfunded;
* If buyer does not deposit the principal token in time, the issuance becomes delinquent;
* If there is no engagement in time, the issuance completes with no engagement.

## Issuance States

Below are the possible states of a lockup contract.

* Initiated: The lockup issuance is created;
* Engageable: The seller deposits the bonus token;
* Active: The buyer engages the lockup issuance;
* Complete Engaged: The lockup period ends;
* Unfunded: The seller fails to deposit the bonus token in time;
* Complete not Engaged: No buyer engages in time;
* Delinquent: The buyer fails to deposit principal token in time.

![](https://3859064823-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LoaA4YYVTuDERPqi-LD%2F-LoaAlnLdaTbWWV9XcCX%2F-LoaApAHWS75LItqI0Yj%2Fnuts-design-diagrams-lockup-contract-state-diagram.jpg?generation=1568303707892823\&alt=media)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nuts.finance/nuts-docs-v1/use-cases/acoconut-lockup-contract.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.