BOS escrow

An escrow contract designed for paying worker proposals. The intention is that the authority for this account would be nulled.

Original source code was gratefully authored by eosDAC.

Caveats

The sender of an escrow will temporarily be whitelisted to BOS executives. In the future anyone may be a sender
The sender may only have one unfilled escrow at any given time, however they may have many filled escrows
To fill an escrow the sender must transfer the BOS tokens to this contract. An unfilled escrow will be filled
The receiver is considered as always approving the escrow. An approval must come from either the sender or the auditor
The sender may only cancel an escrow that has not been filled
The sender may only refund an escrow that has passed it's expiry
Unapprove only removes an existing approval, if the action is made before the receiver uses the claim action
A sender may extend the expiry but not shorten it
The auditor may change extend or shorten the expiry
The auditor may close an escrow. This is essentially the same as refunding it, however without waiting for the expiry to lapse
The auditor may Lock and Unlock an escrow. This prevents ALL actions except unlock and actions made by the auditor.

init

ACTION: `init`

PARAMETERS:

sender is an eosio account name.
receiver is an eosio account name.
arb is an eosio account name.
expires The date/time after which the escrow amount can be refunded by the sender.
memo is a memo to send as the eventual transfer memo at the end of the escrow contract.
ext_reference is a reference to to external id held my another contract or entity as opposed to the internal auto-incrementing key.

INTENT: The intent of init is to create an empty escrow payment agreement for safe and secure funds transfer protecting both sender and receiver for a determined amount of time.

Warning: This action will store the content on the chain in the history logs and the data cannot be deleted later so therefore should only store a unidentifiable hash of content rather than human readable content.

transfer

ACTION: `transfer`

PARAMETERS:

from is an eosio account name.
to is an eosio account name.
quantity is an eosio asset name.
memo is a string that provides a memo for the transfer action.

INTENT: The intent of transfer is to listen and react to the eosio.token contract's transfer action and ensure the correct parameters have been included in the transfer action.

Warning: This action will store the content on the chain in the history logs and the data cannot be deleted later.

approve

ACTION: `approve`

PARAMETERS:

key is a unique identifying integer for an escrow entry.
approver is an eosio account name.

INTENT: The intent of approve is to approve the release of funds to the intended receiver. Each escrow agreement requires at least 2 approvers and can only be approved by the sender, receiver and/or nominated arbitrator.

Warning: This action will store the content on the chain in the history logs and the data cannot be deleted later.

approveext

ACTION: `approveext`

PARAMETERS:

ext_key is a unique identifying integer for an escrow entry as supplied by an external key source.
approver is an eosio account name.

Warning: This action will store the content on the chain in the history logs and the data cannot be deleted later.

unapprove

ACTION: `unapprove`

PARAMETERS:

key is a unique identifying integer for an escrow entry.
disapprover is an eosio account name.

INTENT: The intent of unapprove is to unapprove the release of funds to the intended receiver from a previous approved action. Each escrow agreement requires at least 2 approvers and can only be approved by the sender, receiver and/or nominated arbitrator.

Warning: This action will store the content on the chain in the history logs and the data cannot be deleted later.

unapproveext

ACTION: `unapproveext`

PARAMETERS:

ext_key is a unique identifying integer for an escrow entry as supplied by an external key source.
disapprover is an eosio account name.

Warning: This action will store the content on the chain in the history logs and the data cannot be deleted later.

claim

ACTION: `claim`

PARAMETERS:

key is a unique identifying integer for an escrow entry.

INTENT: The intent of claim is to claim the escrowed funds for an intended receiver after an escrow agreement has met the required approvals.