Interface

Fund Contract

NameTypeDescription
namestringName of fund
descriptionstringA description of the fund
capitalCommitmentfloatSum of capital commitments from the contributorList’s
statusstringcontractLifecycle status field
currencyobjectThe base currency of the fund; #ref Currency
versionsobject[]A list of previous versions of current contract
executeWindowDurationRepresents the lifetime of the fund, defined with an ISO 8601 Duration string e.g. P30D denotes a period of 30 days.
executeEndstringexecuteEnd defines how to calculate the time to transition from EXECUTE to FINALIZE
executeBeginTimestampA defined time to begin execution of the contract. If undefined or Timestamp is in the past then contract will initiate executaion immediately.
executedAtTimestampThe exact time when contract was executed
contributorAccessstringcontributorAccess defines how open the fund are for subscriptions and donations
contributorMinContributionfloatThe minimum investment or donation allowed.
contributorRestrictobject[]NOT IMPLEMENTED
finalizeAtTimestampThe computed time when finalize should accour if no other events defined comes before this.
finalizeProceedsstringfinalizeProceeds defines how remaining funds are treated.
finalizeProceedsForwardAddstringAn alias, address, or fund did linked to a network wallet, to be used when funds are not returned at the end of the fund’s lifetime.
allocationInstrumentstringThe allocationInstrument is the instruments available for allocating funds.
allocationMethodstringThe allocationMethod defines how allocations are triggered.
allocationFundeeTypestringallocationFundeeType Determines the type of fundee (e.g., individual, organization) eligible for the allocation.
allocationClaimWindowDurationThe duration after which an unclaimed allocation will expire.
allocationConditionTypestringallocationConditionType Determines the conditions to apply.
allocationConditionWindowDurationA duration related to the allocationConditionType
allocationConditionGracePeriodDurationA duration before the allocationConditionWindow is used
allocationConditionAlgostringthe allocationConditionAlgo is an algorithm to apply on allocationConditions
allocationConditionDescriptionstringA description of the allocationConditions

contractLifecycle states

ValueDescription
CREATEThe initial stage where the contract is conceptualized and designed.
FREEZEContract is halted and awaiting certian condition or verification. This is also the first state when the contract are deployed.
EXECUTEContract is currently active and operational.
PAUSEDContract is paused, often indicating a temporary stoppage for maintenance or other reasons.
FINALIZEContract is nearing its end of life and going through final calculations, distributions, or other end-of-life processes.
COMPLETEDContract has finished its intended execution and is now completed.
DEPRECATEDContract is no longer in use or supported, often indicating it’s been replaced by a newer version.

executeEnd types

ValueDescription
EXACTContract will transition from EXECUTE to FINALIZE at our shortly after the time determined by adding the duration specified in executePeriod to the executedAt timestamp.
END_OF_RESERVESContract will transition from EXECUTE to FINALIZE at the same time as EXACT or when the attached wallet runs out of funds, whichever happens first. The wallet’s reserves are reviewed at every allocation event.

contributorAccess types

ValueDescription
PRIVATEThis is the most restricted access level. Contributor has to be by direct selected by the fund manager or through meeting specific criteria defined in the contract. Contributor typically need to have owner or write access to interact with the fund.
INVITEAccess is more controlled. The fund manager can directly invite contributors to invest or donate, or contributors can request access, but their participation depends on approval through the fund manager or an automated process defined in the contract.
PUBLICThe fund is open for contributors from the public. Any participant that meets the basic regulatory or contract-defined criteria can invest or donate.

allocationInstrument types

ValueDescription
GRANTFunds are provided as a Grant

allocationMethod types

ValueDescription
AUTOMATEDAllocations are performed automatically based on a predefined set of criteria using a distribution algorithm.
COMMITTEENOT IMPLEMENTED Allocations are determined by a committee, which is a group of entities that collectively decide and agree upon the allocation decisions.

allocationFundee types

ValueDescription
PersonA naturel person
OrganisationNOT IMPLEMENTED An entity defined as a Organisation

allocationCondition types

ValueDescription
DECAYAllocated fund will decay over time.

allocationConditionAlgo types

ValueDescription
LINEAR-
PROGRESSING-

finalizeProceeds types

ValueDescription
FORWARDForward to a predefined wallet or fund.
RETURNThe proceeds are returned to the original contributors.
RECYCLEThe fund is either extended, or a new fund with a similar purpose is created starting afresh.