Skip to main content

Interface: ColonyClientV8

Hierarchy

  • AugmentedIColony<IColony>

  • ColonyAugmentsV3<IColony>

  • ColonyAugmentsV4<IColony>

  • ColonyAugmentsV5<IColony>

  • AddDomainAugmentsB<IColony>

  • MoveFundsBetweenPotsAugmentsB<IColony>

    ColonyClientV8

Properties

_deployedPromise

_deployedPromise: Promise<Contract>

Inherited from

AugmentedIColony._deployedPromise


_runningEvents

_runningEvents: Object

Index signature

[eventTag: string]: RunningEvent

Inherited from

AugmentedIColony._runningEvents


_wrappedEmits

_wrappedEmits: Object

Index signature

[eventTag: string]: (...args: any[]) => void

Inherited from

AugmentedIColony._wrappedEmits


address

Readonly address: string

Inherited from

AugmentedIColony.address


clientType

clientType: ColonyClient

Inherited from

AugmentedIColony.clientType


clientVersion

clientVersion: 8

Overrides

AugmentedIColony.clientVersion


colonyEvents

colonyEvents: IColonyEvents

The colonyEvents contract supports all events across all versions. Isn't that amazing? It's an ethers contract with only events to filter

Inherited from

AugmentedIColony.colonyEvents


deployTransaction

Readonly deployTransaction: TransactionResponse

Inherited from

AugmentedIColony.deployTransaction


estimateGas

estimateGas: ColonyClientV8Estimate

Overrides

AugmentedIColony.estimateGas


filters

filters: Object

Type declaration

NameType
Annotation(agent?: null | string, txHash?: null | BytesLike, metadata?: null) => AnnotationEventFilter
Annotation(address,bytes32,string)(agent?: null | string, txHash?: null | BytesLike, metadata?: null) => AnnotationEventFilter
ArbitraryReputationUpdate(agent?: null, user?: null, skillId?: null, amount?: null) => ArbitraryReputationUpdateEventFilter
ArbitraryReputationUpdate(address,address,uint256,int256)(agent?: null, user?: null, skillId?: null, amount?: null) => ArbitraryReputationUpdateEventFilter
ColonyBootstrapped(agent?: null, users?: null, amounts?: null) => ColonyBootstrappedEventFilter
ColonyBootstrapped(address,address[],int256[])(agent?: null, users?: null, amounts?: null) => ColonyBootstrappedEventFilter
ColonyFundsClaimed(agent?: null, token?: null, fee?: null, payoutRemainder?: null) => ColonyFundsClaimedEventFilter
ColonyFundsClaimed(address,address,uint256,uint256)(agent?: null, token?: null, fee?: null, payoutRemainder?: null) => ColonyFundsClaimedEventFilter
ColonyFundsMovedBetweenFundingPots(agent?: null, fromPot?: null | BigNumberish, toPot?: null | BigNumberish, amount?: null, token?: null) => ColonyFundsMovedBetweenFundingPotsEventFilter
ColonyFundsMovedBetweenFundingPots(address,uint256,uint256,uint256,address)(agent?: null, fromPot?: null | BigNumberish, toPot?: null | BigNumberish, amount?: null, token?: null) => ColonyFundsMovedBetweenFundingPotsEventFilter
ColonyInitialised(agent?: null, colonyNetwork?: null, token?: null) => ColonyInitialisedEventFilter
ColonyInitialised(address,address,address)(agent?: null, colonyNetwork?: null, token?: null) => ColonyInitialisedEventFilter
ColonyMetadata(agent?: null, metadata?: null) => ColonyMetadataEventFilter
ColonyMetadata(address,string)(agent?: null, metadata?: null) => ColonyMetadataEventFilter
ColonyRewardInverseSet(agent?: null, rewardInverse?: null) => ColonyRewardInverseSetEventFilter
ColonyRewardInverseSet(address,uint256)(agent?: null, rewardInverse?: null) => ColonyRewardInverseSetEventFilter
ColonyRoleSet(agent?: null, user?: null | string, domainId?: null | BigNumberish, role?: null | BigNumberish, setTo?: null) => ColonyRoleSetEventFilter
ColonyRoleSet(address,address,uint256,uint8,bool)(agent?: null, user?: null | string, domainId?: null | BigNumberish, role?: null | BigNumberish, setTo?: null) => ColonyRoleSetEventFilter
ColonyUpgraded(agent?: null, oldVersion?: null, newVersion?: null) => ColonyUpgradedEventFilter
ColonyUpgraded(address,uint256,uint256)(agent?: null, oldVersion?: null, newVersion?: null) => ColonyUpgradedEventFilter
DomainAdded(agent?: null, domainId?: null) => DomainAddedEventFilter
DomainAdded(address,uint256)(agent?: null, domainId?: null) => DomainAddedEventFilter
DomainMetadata(agent?: null, domainId?: null | BigNumberish, metadata?: null) => DomainMetadataEventFilter
DomainMetadata(address,uint256,string)(agent?: null, domainId?: null | BigNumberish, metadata?: null) => DomainMetadataEventFilter
ExpenditureAdded(agent?: null, expenditureId?: null) => ExpenditureAddedEventFilter
ExpenditureAdded(address,uint256)(agent?: null, expenditureId?: null) => ExpenditureAddedEventFilter
ExpenditureCancelled(agent?: null, expenditureId?: null | BigNumberish) => ExpenditureCancelledEventFilter
ExpenditureCancelled(address,uint256)(agent?: null, expenditureId?: null | BigNumberish) => ExpenditureCancelledEventFilter
ExpenditureClaimDelaySet(agent?: null, expenditureId?: null | BigNumberish, slot?: null | BigNumberish, claimDelay?: null) => ExpenditureClaimDelaySetEventFilter
ExpenditureClaimDelaySet(address,uint256,uint256,uint256)(agent?: null, expenditureId?: null | BigNumberish, slot?: null | BigNumberish, claimDelay?: null) => ExpenditureClaimDelaySetEventFilter
ExpenditureFinalized(agent?: null, expenditureId?: null | BigNumberish) => ExpenditureFinalizedEventFilter
ExpenditureFinalized(address,uint256)(agent?: null, expenditureId?: null | BigNumberish) => ExpenditureFinalizedEventFilter
ExpenditureGlobalClaimDelaySet(agent?: null, globalClaimDelay?: null) => ExpenditureGlobalClaimDelaySetEventFilter
ExpenditureGlobalClaimDelaySet(address,uint256)(agent?: null, globalClaimDelay?: null) => ExpenditureGlobalClaimDelaySetEventFilter
ExpenditureLocked(agent?: null, expenditureId?: null | BigNumberish) => ExpenditureLockedEventFilter
ExpenditureLocked(address,uint256)(agent?: null, expenditureId?: null | BigNumberish) => ExpenditureLockedEventFilter
ExpenditureMetadataSet(agent?: null, expenditureId?: null | BigNumberish, metadata?: null) => ExpenditureMetadataSetEventFilter
ExpenditureMetadataSet(address,uint256,string)(agent?: null, expenditureId?: null | BigNumberish, metadata?: null) => ExpenditureMetadataSetEventFilter
ExpenditurePayoutModifierSet(agent?: null, expenditureId?: null | BigNumberish, slot?: null | BigNumberish, payoutModifier?: null) => ExpenditurePayoutModifierSetEventFilter
ExpenditurePayoutModifierSet(address,uint256,uint256,int256)(agent?: null, expenditureId?: null | BigNumberish, slot?: null | BigNumberish, payoutModifier?: null) => ExpenditurePayoutModifierSetEventFilter
ExpenditurePayoutSet(agent?: null, expenditureId?: null | BigNumberish, slot?: null | BigNumberish, token?: null | string, amount?: null) => ExpenditurePayoutSetEventFilter
ExpenditurePayoutSet(address,uint256,uint256,address,uint256)(agent?: null, expenditureId?: null | BigNumberish, slot?: null | BigNumberish, token?: null | string, amount?: null) => ExpenditurePayoutSetEventFilter
ExpenditureRecipientSet(agent?: null, expenditureId?: null | BigNumberish, slot?: null | BigNumberish, recipient?: null | string) => ExpenditureRecipientSetEventFilter
ExpenditureRecipientSet(address,uint256,uint256,address)(agent?: null, expenditureId?: null | BigNumberish, slot?: null | BigNumberish, recipient?: null | string) => ExpenditureRecipientSetEventFilter
ExpenditureSkillSet(agent?: null, expenditureId?: null | BigNumberish, slot?: null | BigNumberish, skillId?: null | BigNumberish) => ExpenditureSkillSetEventFilter
ExpenditureSkillSet(address,uint256,uint256,uint256)(agent?: null, expenditureId?: null | BigNumberish, slot?: null | BigNumberish, skillId?: null | BigNumberish) => ExpenditureSkillSetEventFilter
ExpenditureTransferred(agent?: null, expenditureId?: null | BigNumberish, owner?: null | string) => ExpenditureTransferredEventFilter
ExpenditureTransferred(address,uint256,address)(agent?: null, expenditureId?: null | BigNumberish, owner?: null | string) => ExpenditureTransferredEventFilter
FundingPotAdded(fundingPotId?: null) => FundingPotAddedEventFilter
FundingPotAdded(uint256)(fundingPotId?: null) => FundingPotAddedEventFilter
PaymentAdded(agent?: null, paymentId?: null) => PaymentAddedEventFilter
PaymentAdded(address,uint256)(agent?: null, paymentId?: null) => PaymentAddedEventFilter
PaymentFinalized(agent?: null, paymentId?: null | BigNumberish) => PaymentFinalizedEventFilter
PaymentFinalized(address,uint256)(agent?: null, paymentId?: null | BigNumberish) => PaymentFinalizedEventFilter
PaymentPayoutSet(agent?: null, paymentId?: null | BigNumberish, token?: null, amount?: null) => PaymentPayoutSetEventFilter
PaymentPayoutSet(address,uint256,address,uint256)(agent?: null, paymentId?: null | BigNumberish, token?: null, amount?: null) => PaymentPayoutSetEventFilter
PaymentRecipientSet(agent?: null, paymentId?: null | BigNumberish, recipient?: null) => PaymentRecipientSetEventFilter
PaymentRecipientSet(address,uint256,address)(agent?: null, paymentId?: null | BigNumberish, recipient?: null) => PaymentRecipientSetEventFilter
PaymentSkillSet(agent?: null, paymentId?: null | BigNumberish, skillId?: null) => PaymentSkillSetEventFilter
PaymentSkillSet(address,uint256,uint256)(agent?: null, paymentId?: null | BigNumberish, skillId?: null) => PaymentSkillSetEventFilter
PayoutClaimed(agent?: null, fundingPotId?: null | BigNumberish, token?: null, amount?: null) => PayoutClaimedEventFilter
PayoutClaimed(address,uint256,address,uint256)(agent?: null, fundingPotId?: null | BigNumberish, token?: null, amount?: null) => PayoutClaimedEventFilter
RecoveryModeEntered(user?: null) => RecoveryModeEnteredEventFilter
RecoveryModeEntered(address)(user?: null) => RecoveryModeEnteredEventFilter
RecoveryModeExitApproved(user?: null) => RecoveryModeExitApprovedEventFilter
RecoveryModeExitApproved(address)(user?: null) => RecoveryModeExitApprovedEventFilter
RecoveryModeExited(user?: null) => RecoveryModeExitedEventFilter
RecoveryModeExited(address)(user?: null) => RecoveryModeExitedEventFilter
RecoveryRoleSet(user?: null | string, setTo?: null) => RecoveryRoleSetEventFilter
RecoveryRoleSet(address,bool)(user?: null | string, setTo?: null) => RecoveryRoleSetEventFilter
RecoveryStorageSlotSet(user?: null, slot?: null, fromValue?: null, toValue?: null) => RecoveryStorageSlotSetEventFilter
RecoveryStorageSlotSet(address,uint256,bytes32,bytes32)(user?: null, slot?: null, fromValue?: null, toValue?: null) => RecoveryStorageSlotSetEventFilter
RewardPayoutClaimed(rewardPayoutId?: null, user?: null, fee?: null, rewardRemainder?: null) => RewardPayoutClaimedEventFilter
RewardPayoutClaimed(uint256,address,uint256,uint256)(rewardPayoutId?: null, user?: null, fee?: null, rewardRemainder?: null) => RewardPayoutClaimedEventFilter
RewardPayoutCycleEnded(agent?: null, rewardPayoutId?: null) => RewardPayoutCycleEndedEventFilter
RewardPayoutCycleEnded(address,uint256)(agent?: null, rewardPayoutId?: null) => RewardPayoutCycleEndedEventFilter
RewardPayoutCycleStarted(agent?: null, rewardPayoutId?: null) => RewardPayoutCycleStartedEventFilter
RewardPayoutCycleStarted(address,uint256)(agent?: null, rewardPayoutId?: null) => RewardPayoutCycleStartedEventFilter
TaskAdded(agent?: null, taskId?: null) => TaskAddedEventFilter
TaskAdded(address,uint256)(agent?: null, taskId?: null) => TaskAddedEventFilter
TaskBriefSet(taskId?: null | BigNumberish, specificationHash?: null) => TaskBriefSetEventFilter
TaskBriefSet(uint256,bytes32)(taskId?: null | BigNumberish, specificationHash?: null) => TaskBriefSetEventFilter
TaskCanceled(taskId?: null | BigNumberish) => TaskCanceledEventFilter
TaskCanceled(uint256)(taskId?: null | BigNumberish) => TaskCanceledEventFilter
TaskChangedViaSignatures(reviewerAddresses?: null) => TaskChangedViaSignaturesEventFilter
TaskChangedViaSignatures(address[])(reviewerAddresses?: null) => TaskChangedViaSignaturesEventFilter
TaskCompleted(agent?: null, taskId?: null | BigNumberish) => TaskCompletedEventFilter
TaskCompleted(address,uint256)(agent?: null, taskId?: null | BigNumberish) => TaskCompletedEventFilter
TaskDeliverableSubmitted(agent?: null, taskId?: null | BigNumberish, deliverableHash?: null) => TaskDeliverableSubmittedEventFilter
TaskDeliverableSubmitted(address,uint256,bytes32)(agent?: null, taskId?: null | BigNumberish, deliverableHash?: null) => TaskDeliverableSubmittedEventFilter
TaskDueDateSet(taskId?: null | BigNumberish, dueDate?: null) => TaskDueDateSetEventFilter
TaskDueDateSet(uint256,uint256)(taskId?: null | BigNumberish, dueDate?: null) => TaskDueDateSetEventFilter
TaskFinalized(agent?: null, taskId?: null | BigNumberish) => TaskFinalizedEventFilter
TaskFinalized(address,uint256)(agent?: null, taskId?: null | BigNumberish) => TaskFinalizedEventFilter
TaskPayoutSet(taskId?: null | BigNumberish, role?: null, token?: null, amount?: null) => TaskPayoutSetEventFilter
TaskPayoutSet(uint256,uint8,address,uint256)(taskId?: null | BigNumberish, role?: null, token?: null, amount?: null) => TaskPayoutSetEventFilter
TaskRoleUserSet(taskId?: null | BigNumberish, role?: null, user?: null | string) => TaskRoleUserSetEventFilter
TaskRoleUserSet(uint256,uint8,address)(taskId?: null | BigNumberish, role?: null, user?: null | string) => TaskRoleUserSetEventFilter
TaskSkillSet(taskId?: null | BigNumberish, skillId?: null | BigNumberish) => TaskSkillSetEventFilter
TaskSkillSet(uint256,uint256)(taskId?: null | BigNumberish, skillId?: null | BigNumberish) => TaskSkillSetEventFilter
TaskWorkRatingRevealed(agent?: null, taskId?: null | BigNumberish, role?: null, rating?: null) => TaskWorkRatingRevealedEventFilter
TaskWorkRatingRevealed(address,uint256,uint8,uint8)(agent?: null, taskId?: null | BigNumberish, role?: null, rating?: null) => TaskWorkRatingRevealedEventFilter
TokenUnlocked() => TokenUnlockedEventFilter
TokenUnlocked()() => TokenUnlockedEventFilter
TokensBurned(agent?: null, token?: null, amount?: null) => TokensBurnedEventFilter
TokensBurned(address,address,uint256)(agent?: null, token?: null, amount?: null) => TokensBurnedEventFilter
TokensMinted(agent?: null, who?: null, amount?: null) => TokensMintedEventFilter
TokensMinted(address,address,uint256)(agent?: null, who?: null, amount?: null) => TokensMintedEventFilter

Inherited from

AugmentedIColony.filters


interface

interface: IColonyInterface

Inherited from

AugmentedIColony.interface


networkClient

networkClient: ColonyNetworkClient

An instance of the ColonyNetworkClient

Inherited from

AugmentedIColony.networkClient


off

off: OnEvent<ColonyClientV8>

Inherited from

AugmentedIColony.off


on

on: OnEvent<ColonyClientV8>

Inherited from

AugmentedIColony.on


once

once: OnEvent<ColonyClientV8>

Inherited from

AugmentedIColony.once


provider

Readonly provider: Provider

Inherited from

AugmentedIColony.provider


removeListener

removeListener: OnEvent<ColonyClientV8>

Inherited from

AugmentedIColony.removeListener


reputationClient

reputationClient: ReputationClient

A helper client to retrieve reputation

Inherited from

AugmentedIColony.reputationClient


resolvedAddress

Readonly resolvedAddress: Promise<string>

Inherited from

AugmentedIColony.resolvedAddress


signer

Readonly signer: Signer

Inherited from

AugmentedIColony.signer


tokenClient

tokenClient: TokenClient

An instance of the TokenClient for the Colony's native token

Inherited from

AugmentedIColony.tokenClient

Methods

_checkRunningEvents

_checkRunningEvents(runningEvent): void

Parameters

NameType
runningEventRunningEvent

Returns

void

Inherited from

AugmentedIColony._checkRunningEvents


_deployed

_deployed(blockTag?): Promise<Contract>

Parameters

NameType
blockTag?BlockTag

Returns

Promise<Contract>

Inherited from

AugmentedIColony._deployed


_wrapEvent

_wrapEvent(runningEvent, log, listener): Event

Parameters

NameType
runningEventRunningEvent
logLog
listenerListener

Returns

Event

Inherited from

AugmentedIColony._wrapEvent


addDomain(uint256,uint256,uint256)

addDomain(uint256,uint256,uint256)(_permissionDomainId, _childSkillIndex, _parentDomainId, overrides?): Promise<ContractTransaction>

Adding new domains is currently retricted to one level only, i.e. _parentDomainId has to be the root domain id: 1. Add a colony domain, and its respective local skill under skill with id _parentSkillId. New funding pot is created and associated with the domain here.

Parameters

NameTypeDescription
_permissionDomainIdBigNumberishThe domainId in which I have the permission to take this action
_childSkillIndexBigNumberishThe index that the _domainId is relative to _permissionDomainId
_parentDomainIdBigNumberishId of the domain under which the new one will be added
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.addDomain(uint256,uint256,uint256)


addDomain(uint256,uint256,uint256,string)

addDomain(uint256,uint256,uint256,string)(_permissionDomainId, _childSkillIndex, _parentDomainId, _metadata, overrides?): Promise<ContractTransaction>

Adding new domains is currently retricted to one level only, i.e. _parentDomainId has to be the root domain id: 1.We expect this function to only be used by the dapp Add a colony domain, and its respective local skill under skill with id _parentSkillId. New funding pot is created and associated with the domain here.

Parameters

NameTypeDescription
_permissionDomainIdBigNumberishThe domainId in which I have the permission to take this action
_childSkillIndexBigNumberishThe index that the _domainId is relative to _permissionDomainId
_parentDomainIdBigNumberishId of the domain under which the new one will be added
_metadatastringMetadata relating to the domain. Expected to be the IPFS hash of a JSON blob, but not enforced by the contracts.
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.addDomain(uint256,uint256,uint256,string)


addDomainWithProofs(uint256)

addDomainWithProofs(uint256)(_parentDomainId, overrides?): Promise<ContractTransaction>

Same as addDomain(uint256,uint256,uint256), but let colonyJS figure out the permission proofs for you. Always prefer this method, except when you have good reason not to.

Parameters

NameTypeDescription
_parentDomainIdBigNumberishId of the domain under which the new one will be added
overrides?TxOverrides-

Returns

Promise<ContractTransaction>

Inherited from

AddDomainAugmentsB.addDomainWithProofs(uint256)


addDomainWithProofs(uint256,string)

addDomainWithProofs(uint256,string)(_parentDomainId, _metadata, overrides?): Promise<ContractTransaction>

Same as addDomain(uint256,uint256,uint256,string), but let colonyJS figure out the permission proofs for you. Always prefer this method, except when you have good reason not to.

Parameters

NameTypeDescription
_parentDomainIdBigNumberishId of the domain under which the new one will be added
_metadatastringMetadata relating to the domain. Expected to be the IPFS hash of a JSON blob, but not enforced by the contracts.
overrides?TxOverrides-

Returns

Promise<ContractTransaction>

Inherited from

AddDomainAugmentsB.addDomainWithProofs(uint256,string)


addPayment

addPayment(_permissionDomainId, _childSkillIndex, _recipient, _token, _amount, _domainId, _skillId, overrides?): Promise<ContractTransaction>

Add a new payment in the colony. Secured function to authorised members.

Parameters

NameTypeDescription
_permissionDomainIdBigNumberishThe domainId in which I have the permission to take this action
_childSkillIndexBigNumberishThe index that the _domainId is relative to _permissionDomainId, (only used if _permissionDomainId is different to _domainId)
_recipientstringAddress of the payment recipient
_tokenstringAddress of the token, 0x0 value indicates Ether
_amountBigNumberishPayout amount
_domainIdBigNumberishThe domain where the payment belongs
_skillIdBigNumberishThe skill associated with the payment
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.addPayment


addPayment(uint256,uint256,address,address,uint256,uint256,uint256)

addPayment(uint256,uint256,address,address,uint256,uint256,uint256)(_permissionDomainId, _childSkillIndex, _recipient, _token, _amount, _domainId, _skillId, overrides?): Promise<ContractTransaction>

Add a new payment in the colony. Secured function to authorised members.

Parameters

NameTypeDescription
_permissionDomainIdBigNumberishThe domainId in which I have the permission to take this action
_childSkillIndexBigNumberishThe index that the _domainId is relative to _permissionDomainId, (only used if _permissionDomainId is different to _domainId)
_recipientstringAddress of the payment recipient
_tokenstringAddress of the token, 0x0 value indicates Ether
_amountBigNumberishPayout amount
_domainIdBigNumberishThe domain where the payment belongs
_skillIdBigNumberishThe skill associated with the payment
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.addPayment(uint256,uint256,address,address,uint256,uint256,uint256)


addPaymentWithProofs

addPaymentWithProofs(_recipient, _token, _amount, _domainId, _skillId, overrides?): Promise<ContractTransaction>

Same as addPayment, but let colonyJS figure out the permission proofs for you. Always prefer this method, except when you have good reason not to.

Parameters

NameTypeDescription
_recipientstringAddress of the payment recipient
_tokenstringAddress of the token, 0x0 value indicates Ether
_amountBigNumberishPayout amount
_domainIdBigNumberishThe domain where the payment belongs
_skillIdBigNumberishThe skill associated with the payment
overrides?TxOverrides-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.addPaymentWithProofs


annotateTransaction

annotateTransaction(_txHash, _metadata, overrides?): Promise<ContractTransaction>

Emit a metadata string for a transaction

Parameters

NameTypeDescription
_txHashBytesLikeHash of transaction being annotated (0x0 for current tx)
_metadatastringString of metadata for tx
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.annotateTransaction


annotateTransaction(bytes32,string)

annotateTransaction(bytes32,string)(_txHash, _metadata, overrides?): Promise<ContractTransaction>

Emit a metadata string for a transaction

Parameters

NameTypeDescription
_txHashBytesLikeHash of transaction being annotated (0x0 for current tx)
_metadatastringString of metadata for tx
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.annotateTransaction(bytes32,string)


approveExitRecovery

approveExitRecovery(overrides?): Promise<ContractTransaction>

Indicate approval to exit recovery mode. Can only be called by user with recovery role.

Parameters

NameType
overrides?Overrides & { from?: string }

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.approveExitRecovery


approveExitRecovery()

approveExitRecovery()(overrides?): Promise<ContractTransaction>

Indicate approval to exit recovery mode. Can only be called by user with recovery role.

Parameters

NameType
overrides?Overrides & { from?: string }

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.approveExitRecovery()


approveStake

approveStake(_approvee, _domainId, _amount, overrides?): Promise<ContractTransaction>

Allow the _approvee to obligate some amount of tokens as a stake.

Parameters

NameTypeDescription
_approveestringAddress of the account we are willing to let obligate us.
_domainIdBigNumberishDomain in which we are willing to be obligated.
_amountBigNumberishAmount of internal token up to which we are willing to be obligated.
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.approveStake


approveStake(address,uint256,uint256)

approveStake(address,uint256,uint256)(_approvee, _domainId, _amount, overrides?): Promise<ContractTransaction>

Allow the _approvee to obligate some amount of tokens as a stake.

Parameters

NameTypeDescription
_approveestringAddress of the account we are willing to let obligate us.
_domainIdBigNumberishDomain in which we are willing to be obligated.
_amountBigNumberishAmount of internal token up to which we are willing to be obligated.
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.approveStake(address,uint256,uint256)


attach

attach(addressOrName): ColonyClientV8

Parameters

NameType
addressOrNamestring

Returns

ColonyClientV8

Inherited from

AugmentedIColony.attach


authority

authority(overrides?): Promise<string>

Get the ColonyAuthority for the colony.

Parameters

NameType
overrides?CallOverrides

Returns

Promise<string>

Inherited from

AugmentedIColony.authority


authority()

authority()(overrides?): Promise<string>

Get the ColonyAuthority for the colony.

Parameters

NameType
overrides?CallOverrides

Returns

Promise<string>

Inherited from

AugmentedIColony.authority()


bootstrapColony

bootstrapColony(_users, _amount, overrides?): Promise<ContractTransaction>

Only allowed to be called when taskCount is 0 by authorized addresses. Allows the colony to bootstrap itself by having initial reputation and token _amount assigned to _users. This reputation is assigned in the colony-wide domain. Secured function to authorised members.

Parameters

NameTypeDescription
_usersstring[]Array of address to bootstrap with reputation
_amountBigNumberish[]Amount of reputation/tokens for every address
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.bootstrapColony


bootstrapColony(address[],int256[])

bootstrapColony(address[],int256[])(_users, _amount, overrides?): Promise<ContractTransaction>

Only allowed to be called when taskCount is 0 by authorized addresses. Allows the colony to bootstrap itself by having initial reputation and token _amount assigned to _users. This reputation is assigned in the colony-wide domain. Secured function to authorised members.

Parameters

NameTypeDescription
_usersstring[]Array of address to bootstrap with reputation
_amountBigNumberish[]Amount of reputation/tokens for every address
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.bootstrapColony(address[],int256[])


burnTokens

burnTokens(token, amount, overrides?): Promise<ContractTransaction>

Burn tokens held by the colony. Can only burn tokens held in the root funding pot.

Parameters

NameTypeDescription
tokenstringThe address of the token to burn
amountBigNumberishThe amount of tokens to burn
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.burnTokens


burnTokens(address,uint256)

burnTokens(address,uint256)(token, amount, overrides?): Promise<ContractTransaction>

Burn tokens held by the colony. Can only burn tokens held in the root funding pot.

Parameters

NameTypeDescription
tokenstringThe address of the token to burn
amountBigNumberishThe amount of tokens to burn
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.burnTokens(address,uint256)


cancelExpenditure

cancelExpenditure(_id, overrides?): Promise<ContractTransaction>

Cancels the expenditure and prevents further editing. Can only be called by expenditure owner.

Parameters

NameTypeDescription
_idBigNumberishExpenditure identifier
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.cancelExpenditure


cancelExpenditure(uint256)

cancelExpenditure(uint256)(_id, overrides?): Promise<ContractTransaction>

Cancels the expenditure and prevents further editing. Can only be called by expenditure owner.

Parameters

NameTypeDescription
_idBigNumberishExpenditure identifier
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.cancelExpenditure(uint256)


cancelTask

cancelTask(_id, overrides?): Promise<ContractTransaction>

Set the task.status property to 1. Cancel a task at any point before it is finalized. Secured function to authorised members. Any funds assigned to its funding pot can be moved back to the domain via IColony.moveFundsBetweenPots.

Parameters

NameTypeDescription
_idBigNumberishId of the task
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.cancelTask


cancelTask(uint256)

cancelTask(uint256)(_id, overrides?): Promise<ContractTransaction>

Set the task.status property to 1. Cancel a task at any point before it is finalized. Secured function to authorised members. Any funds assigned to its funding pot can be moved back to the domain via IColony.moveFundsBetweenPots.

Parameters

NameTypeDescription
_idBigNumberishId of the task
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.cancelTask(uint256)


checkNotAdditionalProtectedVariable

checkNotAdditionalProtectedVariable(_slot, overrides?): Promise<void>

No return value, but should throw if protected.This is external, but is only expected to be called from ContractRecovery; no need toexpose this to any users. Check whether the supplied slot is a protected variable specific to this contract

Parameters

NameTypeDescription
_slotBigNumberishThe storage slot number to check.
overrides?CallOverrides-

Returns

Promise<void>

Inherited from

AugmentedIColony.checkNotAdditionalProtectedVariable


checkNotAdditionalProtectedVariable(uint256)

checkNotAdditionalProtectedVariable(uint256)(_slot, overrides?): Promise<void>

No return value, but should throw if protected.This is external, but is only expected to be called from ContractRecovery; no need toexpose this to any users. Check whether the supplied slot is a protected variable specific to this contract

Parameters

NameTypeDescription
_slotBigNumberishThe storage slot number to check.
overrides?CallOverrides-

Returns

Promise<void>

Inherited from

AugmentedIColony.checkNotAdditionalProtectedVariable(uint256)


claimColonyFunds

claimColonyFunds(_token, overrides?): Promise<ContractTransaction>

Move any funds received by the colony in _token denomination to the top-level domain pot, siphoning off a small amount to the reward pot. If called against a colony's own token, no fee is taken.

Parameters

NameTypeDescription
_tokenstringAddress of the token, 0x0 value indicates Ether
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.claimColonyFunds


claimColonyFunds(address)

claimColonyFunds(address)(_token, overrides?): Promise<ContractTransaction>

Move any funds received by the colony in _token denomination to the top-level domain pot, siphoning off a small amount to the reward pot. If called against a colony's own token, no fee is taken.

Parameters

NameTypeDescription
_tokenstringAddress of the token, 0x0 value indicates Ether
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.claimColonyFunds(address)


claimExpenditurePayout

claimExpenditurePayout(_id, _slot, _token, overrides?): Promise<ContractTransaction>

Claim the payout for an expenditure slot. Here the network receives a fee from each payout.

Parameters

NameTypeDescription
_idBigNumberishExpenditure identifier
_slotBigNumberishNumber of the slot
_tokenstringAddress of the token, 0x0 value indicates Ether
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.claimExpenditurePayout


claimExpenditurePayout(uint256,uint256,address)

claimExpenditurePayout(uint256,uint256,address)(_id, _slot, _token, overrides?): Promise<ContractTransaction>

Claim the payout for an expenditure slot. Here the network receives a fee from each payout.

Parameters

NameTypeDescription
_idBigNumberishExpenditure identifier
_slotBigNumberishNumber of the slot
_tokenstringAddress of the token, 0x0 value indicates Ether
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.claimExpenditurePayout(uint256,uint256,address)


claimPayment

claimPayment(_id, _token, overrides?): Promise<ContractTransaction>

Claim the payout in _token denomination for payment _id. Here the network receives its fee from each payout. Same as for tasks, ether fees go straight to the Meta Colony whereas Token fees go to the Network to be auctioned off.

Parameters

NameTypeDescription
_idBigNumberishPayment identifier
_tokenstringAddress of the token, 0x0 value indicates Ether
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.claimPayment


claimPayment(uint256,address)

claimPayment(uint256,address)(_id, _token, overrides?): Promise<ContractTransaction>

Claim the payout in _token denomination for payment _id. Here the network receives its fee from each payout. Same as for tasks, ether fees go straight to the Meta Colony whereas Token fees go to the Network to be auctioned off.

Parameters

NameTypeDescription
_idBigNumberishPayment identifier
_tokenstringAddress of the token, 0x0 value indicates Ether
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.claimPayment(uint256,address)


claimRewardPayout

claimRewardPayout(_payoutId, _squareRoots, key, value, branchMask, siblings, overrides?): Promise<ContractTransaction>

Claim the reward payout at _payoutId. User needs to provide their reputation and colony-wide reputation which will be proven via Merkle proof inside this function. Can only be called if payout is active, i.e if 60 days have not passed from its creation. Can only be called if next in queue.

Parameters

NameTypeDescription
_payoutIdBigNumberishId of the reward payout
_squareRootsBigNumberish[]Square roots of values used in equation: _squareRoots[0] - square root of user reputation, _squareRoots[1] - square root of user tokens (deposited in TokenLocking), _squareRoots[2] - square root of total reputation, _squareRoots[3] - square root of total tokens, _squareRoots[4] - square root of numerator (user reputation user tokens), _squareRoots[5] - square root of denominator (total reputation total tokens), _squareRoots[6] - square root of payout amount.
keyBytesLikeSome Reputation hash tree key
valueBytesLikeReputation value
branchMaskBigNumberishThe branchmask of the proof
siblingsBytesLike[]The siblings of the proof
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.claimRewardPayout


claimRewardPayout(uint256,uint256[7],bytes,bytes,uint256,bytes32[])

claimRewardPayout(uint256,uint256[7],bytes,bytes,uint256,bytes32[])(_payoutId, _squareRoots, key, value, branchMask, siblings, overrides?): Promise<ContractTransaction>

Claim the reward payout at _payoutId. User needs to provide their reputation and colony-wide reputation which will be proven via Merkle proof inside this function. Can only be called if payout is active, i.e if 60 days have not passed from its creation. Can only be called if next in queue.

Parameters

NameTypeDescription
_payoutIdBigNumberishId of the reward payout
_squareRootsBigNumberish[]Square roots of values used in equation: _squareRoots[0] - square root of user reputation, _squareRoots[1] - square root of user tokens (deposited in TokenLocking), _squareRoots[2] - square root of total reputation, _squareRoots[3] - square root of total tokens, _squareRoots[4] - square root of numerator (user reputation user tokens), _squareRoots[5] - square root of denominator (total reputation total tokens), _squareRoots[6] - square root of payout amount.
keyBytesLikeSome Reputation hash tree key
valueBytesLikeReputation value
branchMaskBigNumberishThe branchmask of the proof
siblingsBytesLike[]The siblings of the proof
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.claimRewardPayout(uint256,uint256[7],bytes,bytes,uint256,bytes32[])


claimTaskPayout

claimTaskPayout(_id, _role, _token, overrides?): Promise<ContractTransaction>

Claim the payout in _token denomination for work completed in task _id by contributor with role _role. Allowed only after task is finalized. Here the network receives its fee from each payout. Ether fees go straight to the Meta Colony whereas Token fees go to the Network to be auctioned off.

Parameters

NameTypeDescription
_idBigNumberishId of the task
_roleBigNumberishId of the role, as defined in TaskRole enum
_tokenstringAddress of the token, 0x0 value indicates Ether
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.claimTaskPayout


claimTaskPayout(uint256,uint8,address)

claimTaskPayout(uint256,uint8,address)(_id, _role, _token, overrides?): Promise<ContractTransaction>

Claim the payout in _token denomination for work completed in task _id by contributor with role _role. Allowed only after task is finalized. Here the network receives its fee from each payout. Ether fees go straight to the Meta Colony whereas Token fees go to the Network to be auctioned off.

Parameters

NameTypeDescription
_idBigNumberishId of the task
_roleBigNumberishId of the role, as defined in TaskRole enum
_tokenstringAddress of the token, 0x0 value indicates Ether
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.claimTaskPayout(uint256,uint8,address)


completeTask

completeTask(_id, overrides?): Promise<ContractTransaction>

Mark a task as complete after the due date has passed. This allows the task to be rated and finalized (and funds recovered) even in the presence of a worker who has disappeared. Note that if the due date was not set, then this function will throw.

Parameters

NameTypeDescription
_idBigNumberishId of the task
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.completeTask


completeTask(uint256)

completeTask(uint256)(_id, overrides?): Promise<ContractTransaction>

Mark a task as complete after the due date has passed. This allows the task to be rated and finalized (and funds recovered) even in the presence of a worker who has disappeared. Note that if the due date was not set, then this function will throw.

Parameters

NameTypeDescription
_idBigNumberishId of the task
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.completeTask(uint256)


connect

connect(signerOrProvider): ColonyClientV8

Parameters

NameType
signerOrProviderstring | Signer | Provider

Returns

ColonyClientV8

Inherited from

AugmentedIColony.connect


deobligateStake

deobligateStake(_user, _domainId, _amount, overrides?): Promise<ContractTransaction>

Deobligate the user some amount of tokens, releasing the stake.

Parameters

NameTypeDescription
_userstringAddress of the account we are deobligating.
_domainIdBigNumberishDomain in which we are deobligating the user.
_amountBigNumberishAmount of internal token we are deobligating.
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.deobligateStake


deobligateStake(address,uint256,uint256)

deobligateStake(address,uint256,uint256)(_user, _domainId, _amount, overrides?): Promise<ContractTransaction>

Deobligate the user some amount of tokens, releasing the stake.

Parameters

NameTypeDescription
_userstringAddress of the account we are deobligating.
_domainIdBigNumberishDomain in which we are deobligating the user.
_amountBigNumberishAmount of internal token we are deobligating.
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.deobligateStake(address,uint256,uint256)


deployed

deployed(): Promise<ColonyClientV8>

Returns

Promise<ColonyClientV8>

Inherited from

AugmentedIColony.deployed


deprecateExtension

deprecateExtension(extensionId, deprecated, overrides?): Promise<ContractTransaction>

Set the deprecation of an extension in a colony. Secured function to authorised members.

Parameters

NameTypeDescription
extensionIdBytesLikekeccak256 hash of the extension name, used as an indentifier
deprecatedbooleanWhether to deprecate the extension or not
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.deprecateExtension


deprecateExtension(bytes32,bool)

deprecateExtension(bytes32,bool)(extensionId, deprecated, overrides?): Promise<ContractTransaction>

Set the deprecation of an extension in a colony. Secured function to authorised members.

Parameters

NameTypeDescription
extensionIdBytesLikekeccak256 hash of the extension name, used as an indentifier
deprecatedbooleanWhether to deprecate the extension or not
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.deprecateExtension(bytes32,bool)


editColony

editColony(_metadata, overrides?): Promise<ContractTransaction>

Called to change the metadata associated with a colony. Expected to be a IPFS hash of a JSON blob, but not enforced to any degree by the contracts

Parameters

NameTypeDescription
_metadatastringIPFS hash of the metadata
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.editColony


editColony(string)

editColony(string)(_metadata, overrides?): Promise<ContractTransaction>

Called to change the metadata associated with a colony. Expected to be a IPFS hash of a JSON blob, but not enforced to any degree by the contracts

Parameters

NameTypeDescription
_metadatastringIPFS hash of the metadata
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.editColony(string)


editDomain

editDomain(_permissionDomainId, _childSkillIndex, _domainId, _metadata, overrides?): Promise<ContractTransaction>

Add a colony domain, and its respective local skill under skill with id _parentSkillId. New funding pot is created and associated with the domain here.

Parameters

NameTypeDescription
_permissionDomainIdBigNumberishThe domainId in which I have the permission to take this action
_childSkillIndexBigNumberishThe index that the _domainId is relative to _permissionDomainId
_domainIdBigNumberishId of the domain being edited
_metadatastringMetadata relating to the domain. Expected to be the IPFS hash of a JSON blob, but not enforced by the contracts.
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.editDomain


editDomain(uint256,uint256,uint256,string)

editDomain(uint256,uint256,uint256,string)(_permissionDomainId, _childSkillIndex, _domainId, _metadata, overrides?): Promise<ContractTransaction>

Add a colony domain, and its respective local skill under skill with id _parentSkillId. New funding pot is created and associated with the domain here.

Parameters

NameTypeDescription
_permissionDomainIdBigNumberishThe domainId in which I have the permission to take this action
_childSkillIndexBigNumberishThe index that the _domainId is relative to _permissionDomainId
_domainIdBigNumberishId of the domain being edited
_metadatastringMetadata relating to the domain. Expected to be the IPFS hash of a JSON blob, but not enforced by the contracts.
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.editDomain(uint256,uint256,uint256,string)


editDomainWithProofs

editDomainWithProofs(_domainId, _metadata, overrides?): Promise<ContractTransaction>

Same as editDomain, but let colonyJS figure out the permission proofs for you. Always prefer this method, except when you have good reason not to.

Parameters

NameTypeDescription
_domainIdBigNumberishId of the domain being edited
_metadatastringMetadata relating to the domain. Expected to be the IPFS hash of a JSON blob, but not enforced by the contracts.
overrides?TxOverrides-

Returns

Promise<ContractTransaction>

Inherited from

ColonyAugmentsV5.editDomainWithProofs


emit

emit(eventName, ...args): boolean

Parameters

NameType
eventNamestring | EventFilter
...argsany[]

Returns

boolean

Inherited from

AugmentedIColony.emit


emitDomainReputationPenalty

emitDomainReputationPenalty(_permissionDomainId, _childSkillIndex, _domainId, _user, _amount, overrides?): Promise<ContractTransaction>

Emit a negative domain reputation update. Available only to Arbitration role holders

Parameters

NameTypeDescription
_permissionDomainIdBigNumberishThe domainId in which I hold the Arbitration role
_childSkillIndexBigNumberishThe index that the _domainId is relative to _permissionDomainId
_domainIdBigNumberishThe domain where the user will lose reputation
_userstringThe user who will lose reputation
_amountBigNumberishThe (negative) amount of reputation to lose
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.emitDomainReputationPenalty


emitDomainReputationPenalty(uint256,uint256,uint256,address,int256)

emitDomainReputationPenalty(uint256,uint256,uint256,address,int256)(_permissionDomainId, _childSkillIndex, _domainId, _user, _amount, overrides?): Promise<ContractTransaction>

Emit a negative domain reputation update. Available only to Arbitration role holders

Parameters

NameTypeDescription
_permissionDomainIdBigNumberishThe domainId in which I hold the Arbitration role
_childSkillIndexBigNumberishThe index that the _domainId is relative to _permissionDomainId
_domainIdBigNumberishThe domain where the user will lose reputation
_userstringThe user who will lose reputation
_amountBigNumberishThe (negative) amount of reputation to lose
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.emitDomainReputationPenalty(uint256,uint256,uint256,address,int256)


emitDomainReputationPenaltyWithProofs

emitDomainReputationPenaltyWithProofs(_domainId, _user, _amount, overrides?): Promise<ContractTransaction>

Same as emitDomainReputationPenalty, but let colonyJS figure out the permission proofs for you. Always prefer this method, except when you have good reason not to.

Parameters

NameTypeDescription
_domainIdBigNumberishThe domain where the user will lose reputation
_userstringThe user who will lose reputation
_amountBigNumberishThe (negative) amount of reputation to lose
overrides?TxOverrides-

Returns

Promise<ContractTransaction>

Inherited from

ColonyAugmentsV5.emitDomainReputationPenaltyWithProofs


emitDomainReputationReward

emitDomainReputationReward(_domainId, _user, _amount, overrides?): Promise<ContractTransaction>

Emit a positive domain reputation update. Available only to Root role holders

Parameters

NameTypeDescription
_domainIdBigNumberishThe domain where the user will gain reputation
_userstringThe user who will gain reputation
_amountBigNumberishThe (positive) amount of reputation to gain
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.emitDomainReputationReward


emitDomainReputationReward(uint256,address,int256)

emitDomainReputationReward(uint256,address,int256)(_domainId, _user, _amount, overrides?): Promise<ContractTransaction>

Emit a positive domain reputation update. Available only to Root role holders

Parameters

NameTypeDescription
_domainIdBigNumberishThe domain where the user will gain reputation
_userstringThe user who will gain reputation
_amountBigNumberishThe (positive) amount of reputation to gain
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.emitDomainReputationReward(uint256,address,int256)


emitSkillReputationPenalty

emitSkillReputationPenalty(_skillId, _user, _amount, overrides?): Promise<ContractTransaction>

Emit a negative skill reputation update. Available only to Arbitration role holders in the root domain

Parameters

NameTypeDescription
_skillIdBigNumberishThe skill where the user will lose reputation
_userstringThe user who will lose reputation
_amountBigNumberishThe (negative) amount of reputation to lose
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.emitSkillReputationPenalty


emitSkillReputationPenalty(uint256,address,int256)

emitSkillReputationPenalty(uint256,address,int256)(_skillId, _user, _amount, overrides?): Promise<ContractTransaction>

Emit a negative skill reputation update. Available only to Arbitration role holders in the root domain

Parameters

NameTypeDescription
_skillIdBigNumberishThe skill where the user will lose reputation
_userstringThe user who will lose reputation
_amountBigNumberishThe (negative) amount of reputation to lose
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.emitSkillReputationPenalty(uint256,address,int256)


emitSkillReputationReward

emitSkillReputationReward(_skillId, _user, _amount, overrides?): Promise<ContractTransaction>

Emit a positive skill reputation update. Available only to Root role holders

Parameters

NameTypeDescription
_skillIdBigNumberishThe skill where the user will gain reputation
_userstringThe user who will gain reputation
_amountBigNumberishThe (positive) amount of reputation to gain
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.emitSkillReputationReward


emitSkillReputationReward(uint256,address,int256)

emitSkillReputationReward(uint256,address,int256)(_skillId, _user, _amount, overrides?): Promise<ContractTransaction>

Emit a positive skill reputation update. Available only to Root role holders

Parameters

NameTypeDescription
_skillIdBigNumberishThe skill where the user will gain reputation
_userstringThe user who will gain reputation
_amountBigNumberishThe (positive) amount of reputation to gain
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.emitSkillReputationReward(uint256,address,int256)


enterRecoveryMode

enterRecoveryMode(overrides?): Promise<ContractTransaction>

Put colony network mining into recovery mode. Can only be called by user with recovery role.

Parameters

NameType
overrides?Overrides & { from?: string }

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.enterRecoveryMode


enterRecoveryMode()

enterRecoveryMode()(overrides?): Promise<ContractTransaction>

Put colony network mining into recovery mode. Can only be called by user with recovery role.

Parameters

NameType
overrides?Overrides & { from?: string }

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.enterRecoveryMode()


executeTaskChange

executeTaskChange(_sigV, _sigR, _sigS, _mode, _value, _data, overrides?): Promise<ContractTransaction>

The Colony functions which require approval and the task roles to review these are set in IColony.initialiseColony at colony creation. Upon successful execution the taskChangeNonces entry for the task is incremented. Executes a task update transaction _data which is approved and signed by two of its roles (e.g. manager and worker) using the detached signatures for these users.

Parameters

NameTypeDescription
_sigVBigNumberish[]recovery id
_sigRBytesLike[]r output of the ECDSA signature of the transaction
_sigSBytesLike[]s output of the ECDSA signature of the transaction
_modeBigNumberish[]How the signature was generated - 0 for Geth-style (usual), 1 for Trezor-style (only Trezor does this)
_valueBigNumberishThe transaction value, i.e. number of wei to be sent when the transaction is executed Currently we only accept 0 value transactions but this is kept as a future option
_dataBytesLikeThe transaction data
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.executeTaskChange


executeTaskChange(uint8[],bytes32[],bytes32[],uint8[],uint256,bytes)

executeTaskChange(uint8[],bytes32[],bytes32[],uint8[],uint256,bytes)(_sigV, _sigR, _sigS, _mode, _value, _data, overrides?): Promise<ContractTransaction>

The Colony functions which require approval and the task roles to review these are set in IColony.initialiseColony at colony creation. Upon successful execution the taskChangeNonces entry for the task is incremented. Executes a task update transaction _data which is approved and signed by two of its roles (e.g. manager and worker) using the detached signatures for these users.

Parameters

NameTypeDescription
_sigVBigNumberish[]recovery id
_sigRBytesLike[]r output of the ECDSA signature of the transaction
_sigSBytesLike[]s output of the ECDSA signature of the transaction
_modeBigNumberish[]How the signature was generated - 0 for Geth-style (usual), 1 for Trezor-style (only Trezor does this)
_valueBigNumberishThe transaction value, i.e. number of wei to be sent when the transaction is executed Currently we only accept 0 value transactions but this is kept as a future option
_dataBytesLikeThe transaction data
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.executeTaskChange(uint8[],bytes32[],bytes32[],uint8[],uint256,bytes)


executeTaskRoleAssignment

executeTaskRoleAssignment(_sigV, _sigR, _sigS, _mode, _value, _data, overrides?): Promise<ContractTransaction>

Executes a task role update transaction _data which is approved and signed by two of addresses. depending of which function we are calling. Allowed functions are setTaskManagerRole, setTaskEvaluatorRole and setTaskWorkerRole. Upon successful execution the taskChangeNonces entry for the task is incremented.

Parameters

NameTypeDescription
_sigVBigNumberish[]recovery id
_sigRBytesLike[]r output of the ECDSA signature of the transaction
_sigSBytesLike[]s output of the ECDSA signature of the transaction
_modeBigNumberish[]How the signature was generated - 0 for Geth-style (usual), 1 for Trezor-style (only Trezor does this)
_valueBigNumberishThe transaction value, i.e. number of wei to be sent when the transaction is executed Currently we only accept 0 value transactions but this is kept as a future option
_dataBytesLikeThe transaction data
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.executeTaskRoleAssignment


executeTaskRoleAssignment(uint8[],bytes32[],bytes32[],uint8[],uint256,bytes)

executeTaskRoleAssignment(uint8[],bytes32[],bytes32[],uint8[],uint256,bytes)(_sigV, _sigR, _sigS, _mode, _value, _data, overrides?): Promise<ContractTransaction>

Executes a task role update transaction _data which is approved and signed by two of addresses. depending of which function we are calling. Allowed functions are setTaskManagerRole, setTaskEvaluatorRole and setTaskWorkerRole. Upon successful execution the taskChangeNonces entry for the task is incremented.

Parameters

NameTypeDescription
_sigVBigNumberish[]recovery id
_sigRBytesLike[]r output of the ECDSA signature of the transaction
_sigSBytesLike[]s output of the ECDSA signature of the transaction
_modeBigNumberish[]How the signature was generated - 0 for Geth-style (usual), 1 for Trezor-style (only Trezor does this)
_valueBigNumberishThe transaction value, i.e. number of wei to be sent when the transaction is executed Currently we only accept 0 value transactions but this is kept as a future option
_dataBytesLikeThe transaction data
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.executeTaskRoleAssignment(uint8[],bytes32[],bytes32[],uint8[],uint256,bytes)


exitRecoveryMode

exitRecoveryMode(overrides?): Promise<ContractTransaction>

Exit recovery mode, can be called by anyone if enough whitelist approvals are given.

Parameters

NameType
overrides?Overrides & { from?: string }

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.exitRecoveryMode


exitRecoveryMode()

exitRecoveryMode()(overrides?): Promise<ContractTransaction>

Exit recovery mode, can be called by anyone if enough whitelist approvals are given.

Parameters

NameType
overrides?Overrides & { from?: string }

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.exitRecoveryMode()


fallback

fallback(overrides?): Promise<TransactionResponse>

Parameters

NameType
overrides?TransactionRequest

Returns

Promise<TransactionResponse>

Inherited from

AugmentedIColony.fallback


finalizeExpenditure

finalizeExpenditure(_id, overrides?): Promise<ContractTransaction>

Finalizes the expenditure and allows for funds to be claimed. Can only be called by expenditure owner.

Parameters

NameTypeDescription
_idBigNumberishExpenditure identifier
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.finalizeExpenditure


finalizeExpenditure(uint256)

finalizeExpenditure(uint256)(_id, overrides?): Promise<ContractTransaction>

Finalizes the expenditure and allows for funds to be claimed. Can only be called by expenditure owner.

Parameters

NameTypeDescription
_idBigNumberishExpenditure identifier
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.finalizeExpenditure(uint256)


finalizePayment

finalizePayment(_permissionDomainId, _childSkillIndex, _id, overrides?): Promise<ContractTransaction>

Finalizes the payment and logs the reputation log updates. Allowed to be called once after payment is fully funded. Secured function to authorised members.

Parameters

NameTypeDescription
_permissionDomainIdBigNumberishThe domainId in which I have the permission to take this action
_childSkillIndexBigNumberishThe index that the _domainId is relative to _permissionDomainId
_idBigNumberishPayment identifier
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.finalizePayment


finalizePayment(uint256,uint256,uint256)

finalizePayment(uint256,uint256,uint256)(_permissionDomainId, _childSkillIndex, _id, overrides?): Promise<ContractTransaction>

Finalizes the payment and logs the reputation log updates. Allowed to be called once after payment is fully funded. Secured function to authorised members.

Parameters

NameTypeDescription
_permissionDomainIdBigNumberishThe domainId in which I have the permission to take this action
_childSkillIndexBigNumberishThe index that the _domainId is relative to _permissionDomainId
_idBigNumberishPayment identifier
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.finalizePayment(uint256,uint256,uint256)


finalizePaymentWithProofs

finalizePaymentWithProofs(_id, overrides?): Promise<ContractTransaction>

Same as finalizePayment, but let colonyJS figure out the permission proofs for you. Always prefer this method, except when you have good reason not to.

Parameters

NameTypeDescription
_idBigNumberishPayment identifier
overrides?TxOverrides-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.finalizePaymentWithProofs


finalizeRewardPayout

finalizeRewardPayout(_payoutId, overrides?): Promise<ContractTransaction>

Finalises the reward payout. Allows creation of next reward payouts for token that has been used in _payoutId. Can only be called when reward payout cycle is finished i.e when 60 days have passed from its creation.

Parameters

NameTypeDescription
_payoutIdBigNumberishId of the reward payout
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.finalizeRewardPayout


finalizeRewardPayout(uint256)

finalizeRewardPayout(uint256)(_payoutId, overrides?): Promise<ContractTransaction>

Finalises the reward payout. Allows creation of next reward payouts for token that has been used in _payoutId. Can only be called when reward payout cycle is finished i.e when 60 days have passed from its creation.

Parameters

NameTypeDescription
_payoutIdBigNumberishId of the reward payout
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.finalizeRewardPayout(uint256)


finalizeTask

finalizeTask(_id, overrides?): Promise<ContractTransaction>

Set the task.finalized property to true Called after task work rating is complete which closes the task and logs the respective reputation log updates. Allowed to be called once per task. Secured function to authorised members.

Parameters

NameTypeDescription
_idBigNumberishId of the task
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.finalizeTask


finalizeTask(uint256)

finalizeTask(uint256)(_id, overrides?): Promise<ContractTransaction>

Set the task.finalized property to true Called after task work rating is complete which closes the task and logs the respective reputation log updates. Allowed to be called once per task. Secured function to authorised members.

Parameters

NameTypeDescription
_idBigNumberishId of the task
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.finalizeTask(uint256)


finishUpgrade

finishUpgrade(overrides?): Promise<ContractTransaction>

Can only be called by the colony itself, and only expected to be called as part of the upgrade() call. Required to be external so it can be an external call. A function to be called after an upgrade has been done from v2 to v3.

Parameters

NameType
overrides?Overrides & { from?: string }

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.finishUpgrade


finishUpgrade()

finishUpgrade()(overrides?): Promise<ContractTransaction>

Can only be called by the colony itself, and only expected to be called as part of the upgrade() call. Required to be external so it can be an external call. A function to be called after an upgrade has been done from v2 to v3.

Parameters

NameType
overrides?Overrides & { from?: string }

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.finishUpgrade()


generateSecret

generateSecret(_salt, _value, overrides?): Promise<string>

Helper function used to generage consistently the rating secret using salt value _salt and value to hide _value

Parameters

NameTypeDescription
_saltBytesLikeSalt value
_valueBigNumberishValue to hide
overrides?CallOverrides-

Returns

Promise<string>

Inherited from

AugmentedIColony.generateSecret


generateSecret(bytes32,uint256)

generateSecret(bytes32,uint256)(_salt, _value, overrides?): Promise<string>

Helper function used to generage consistently the rating secret using salt value _salt and value to hide _value

Parameters

NameTypeDescription
_saltBytesLikeSalt value
_valueBigNumberishValue to hide
overrides?CallOverrides-

Returns

Promise<string>

Inherited from

AugmentedIColony.generateSecret(bytes32,uint256)


getApproval

getApproval(_user, _obligator, _domainId, overrides?): Promise<BigNumber>

View an approval to obligate tokens.

Parameters

NameTypeDescription
_userstringUser allowing their tokens to be obligated.
_obligatorstringAddress of the account we are willing to let obligate us.
_domainIdBigNumberishDomain in which we are willing to be obligated.
overrides?CallOverrides-

Returns

Promise<BigNumber>

Inherited from

AugmentedIColony.getApproval


getApproval(address,address,uint256)

getApproval(address,address,uint256)(_user, _obligator, _domainId, overrides?): Promise<BigNumber>

View an approval to obligate tokens.

Parameters

NameTypeDescription
_userstringUser allowing their tokens to be obligated.
_obligatorstringAddress of the account we are willing to let obligate us.
_domainIdBigNumberishDomain in which we are willing to be obligated.
overrides?CallOverrides-

Returns

Promise<BigNumber>

Inherited from

AugmentedIColony.getApproval(address,address,uint256)


getCapabilityRoles

getCapabilityRoles(_sig, overrides?): Promise<string>

Gets the bytes32 representation of the roles authorized to call a function

Parameters

NameTypeDescription
_sigBytesLikeThe function signature
overrides?CallOverrides-

Returns

Promise<string>

Inherited from

AugmentedIColony.getCapabilityRoles


getCapabilityRoles(bytes4)

getCapabilityRoles(bytes4)(_sig, overrides?): Promise<string>

Gets the bytes32 representation of the roles authorized to call a function

Parameters

NameTypeDescription
_sigBytesLikeThe function signature
overrides?CallOverrides-

Returns

Promise<string>

Inherited from

AugmentedIColony.getCapabilityRoles(bytes4)


getColonyNetwork

getColonyNetwork(overrides?): Promise<string>

The colonyNetworkAddress we read here is set once, during initialiseColony. Returns the colony network address set on the Colony.

Parameters

NameType
overrides?CallOverrides

Returns

Promise<string>

Inherited from

AugmentedIColony.getColonyNetwork


getColonyNetwork()

getColonyNetwork()(overrides?): Promise<string>

The colonyNetworkAddress we read here is set once, during initialiseColony. Returns the colony network address set on the Colony.

Parameters

NameType
overrides?CallOverrides

Returns

Promise<string>

Inherited from

AugmentedIColony.getColonyNetwork()


getDomain

getDomain(_id, overrides?): Promise<DomainStructOutput>

Get a domain by id.

Parameters

NameTypeDescription
_idBigNumberishId of the domain which details to get
overrides?CallOverrides-

Returns

Promise<DomainStructOutput>

Inherited from

AugmentedIColony.getDomain


getDomain(uint256)

getDomain(uint256)(_id, overrides?): Promise<DomainStructOutput>

Get a domain by id.

Parameters

NameTypeDescription
_idBigNumberishId of the domain which details to get
overrides?CallOverrides-

Returns

Promise<DomainStructOutput>

Inherited from

AugmentedIColony.getDomain(uint256)


getDomainCount

getDomainCount(overrides?): Promise<BigNumber>

Get the number of domains in the colony.

Parameters

NameType
overrides?CallOverrides

Returns

Promise<BigNumber>

Inherited from

AugmentedIColony.getDomainCount


getDomainCount()

getDomainCount()(overrides?): Promise<BigNumber>

Get the number of domains in the colony.

Parameters

NameType
overrides?CallOverrides

Returns

Promise<BigNumber>

Inherited from

AugmentedIColony.getDomainCount()


getDomainFromFundingPot

getDomainFromFundingPot(_fundingPotId, overrides?): Promise<BigNumber>

Get the domain corresponding to a funding pot

Parameters

NameTypeDescription
_fundingPotIdBigNumberishId of the funding pot
overrides?CallOverrides-

Returns

Promise<BigNumber>

Inherited from

AugmentedIColony.getDomainFromFundingPot


getDomainFromFundingPot(uint256)

getDomainFromFundingPot(uint256)(_fundingPotId, overrides?): Promise<BigNumber>

Get the domain corresponding to a funding pot

Parameters

NameTypeDescription
_fundingPotIdBigNumberishId of the funding pot
overrides?CallOverrides-

Returns

Promise<BigNumber>

Inherited from

AugmentedIColony.getDomainFromFundingPot(uint256)


getExpenditure

getExpenditure(_id, overrides?): Promise<ExpenditureStructOutput>

Returns an existing expenditure.

Parameters

NameTypeDescription
_idBigNumberishExpenditure identifier
overrides?CallOverrides-

Returns

Promise<ExpenditureStructOutput>

Inherited from

AugmentedIColony.getExpenditure


getExpenditure(uint256)

getExpenditure(uint256)(_id, overrides?): Promise<ExpenditureStructOutput>

Returns an existing expenditure.

Parameters

NameTypeDescription
_idBigNumberishExpenditure identifier
overrides?CallOverrides-

Returns

Promise<ExpenditureStructOutput>

Inherited from

AugmentedIColony.getExpenditure(uint256)


getExpenditureCount

getExpenditureCount(overrides?): Promise<BigNumber>

Get the number of expenditures in the colony.

Parameters

NameType
overrides?CallOverrides

Returns

Promise<BigNumber>

Inherited from

AugmentedIColony.getExpenditureCount


getExpenditureCount()

getExpenditureCount()(overrides?): Promise<BigNumber>

Get the number of expenditures in the colony.

Parameters

NameType
overrides?CallOverrides

Returns

Promise<BigNumber>

Inherited from

AugmentedIColony.getExpenditureCount()


getExpenditureSlot

getExpenditureSlot(_id, _slot, overrides?): Promise<ExpenditureSlotStructOutput>

Returns an existing expenditure slot.

Parameters

NameTypeDescription
_idBigNumberishExpenditure identifier
_slotBigNumberishExpenditure slot
overrides?CallOverrides-

Returns

Promise<ExpenditureSlotStructOutput>

Inherited from

AugmentedIColony.getExpenditureSlot


getExpenditureSlot(uint256,uint256)

getExpenditureSlot(uint256,uint256)(_id, _slot, overrides?): Promise<ExpenditureSlotStructOutput>

Returns an existing expenditure slot.

Parameters

NameTypeDescription
_idBigNumberishExpenditure identifier
_slotBigNumberishExpenditure slot
overrides?CallOverrides-

Returns

Promise<ExpenditureSlotStructOutput>

Inherited from

AugmentedIColony.getExpenditureSlot(uint256,uint256)


getExpenditureSlotPayout

getExpenditureSlotPayout(_id, _slot, _token, overrides?): Promise<BigNumber>

Returns an existing expenditure slot's payout for a token.

Parameters

NameTypeDescription
_idBigNumberishExpenditure identifier
_slotBigNumberishExpenditure slot
_tokenstringToken address
overrides?CallOverrides-

Returns

Promise<BigNumber>

Inherited from

AugmentedIColony.getExpenditureSlotPayout


getExpenditureSlotPayout(uint256,uint256,address)

getExpenditureSlotPayout(uint256,uint256,address)(_id, _slot, _token, overrides?): Promise<BigNumber>

Returns an existing expenditure slot's payout for a token.

Parameters

NameTypeDescription
_idBigNumberishExpenditure identifier
_slotBigNumberishExpenditure slot
_tokenstringToken address
overrides?CallOverrides-

Returns

Promise<BigNumber>

Inherited from

AugmentedIColony.getExpenditureSlotPayout(uint256,uint256,address)


getExtensionClient

getExtensionClient<E>(extension): Promise<GetExtensionClientReturns[E]>

Get an instance of an extension client associated with this Colony.

Type parameters

NameType
Eextends Extension

Parameters

NameTypeDescription
extensionEAn Extension

Returns

Promise<GetExtensionClientReturns[E]>

An instance of an intialized extension client for the desired extension

Inherited from

AugmentedIColony.getExtensionClient


getFundingPot

getFundingPot(_id, overrides?): Promise<[number, BigNumber, BigNumber] & { associatedType: number ; associatedTypeId: BigNumber ; payoutsWeCannotMake: BigNumber }>

For the reward funding pot (e.g. id: 0) this returns (0, 0, 0). Get the non-mapping properties of a pot by id.

Parameters

NameTypeDescription
_idBigNumberishId of the pot which details to get
overrides?CallOverrides-

Returns

Promise<[number, BigNumber, BigNumber] & { associatedType: number ; associatedTypeId: BigNumber ; payoutsWeCannotMake: BigNumber }>

Inherited from

AugmentedIColony.getFundingPot


getFundingPot(uint256)

getFundingPot(uint256)(_id, overrides?): Promise<[number, BigNumber, BigNumber] & { associatedType: number ; associatedTypeId: BigNumber ; payoutsWeCannotMake: BigNumber }>

For the reward funding pot (e.g. id: 0) this returns (0, 0, 0). Get the non-mapping properties of a pot by id.

Parameters

NameTypeDescription
_idBigNumberishId of the pot which details to get
overrides?CallOverrides-

Returns

Promise<[number, BigNumber, BigNumber] & { associatedType: number ; associatedTypeId: BigNumber ; payoutsWeCannotMake: BigNumber }>

Inherited from

AugmentedIColony.getFundingPot(uint256)


getFundingPotBalance

getFundingPotBalance(_potId, _token, overrides?): Promise<BigNumber>

Get the _token balance of pot with id _potId.

Parameters

NameTypeDescription
_potIdBigNumberishId of the funding pot
_tokenstringAddress of the token, 0x0 value indicates Ether
overrides?CallOverrides-

Returns

Promise<BigNumber>

Inherited from

AugmentedIColony.getFundingPotBalance


getFundingPotBalance(uint256,address)

getFundingPotBalance(uint256,address)(_potId, _token, overrides?): Promise<BigNumber>

Get the _token balance of pot with id _potId.

Parameters

NameTypeDescription
_potIdBigNumberishId of the funding pot
_tokenstringAddress of the token, 0x0 value indicates Ether
overrides?CallOverrides-

Returns

Promise<BigNumber>

Inherited from

AugmentedIColony.getFundingPotBalance(uint256,address)


getFundingPotCount

getFundingPotCount(overrides?): Promise<BigNumber>

Get the number of funding pots in the colony.

Parameters

NameType
overrides?CallOverrides

Returns

Promise<BigNumber>

Inherited from

AugmentedIColony.getFundingPotCount


getFundingPotCount()

getFundingPotCount()(overrides?): Promise<BigNumber>

Get the number of funding pots in the colony.

Parameters

NameType
overrides?CallOverrides

Returns

Promise<BigNumber>

Inherited from

AugmentedIColony.getFundingPotCount()


getFundingPotPayout

getFundingPotPayout(_potId, _token, overrides?): Promise<BigNumber>

Get the assigned _token payouts of pot with id _potId.

Parameters

NameTypeDescription
_potIdBigNumberishId of the funding pot
_tokenstringAddress of the token, 0x0 value indicates Ether
overrides?CallOverrides-

Returns

Promise<BigNumber>

Inherited from

AugmentedIColony.getFundingPotPayout


getFundingPotPayout(uint256,address)

getFundingPotPayout(uint256,address)(_potId, _token, overrides?): Promise<BigNumber>

Get the assigned _token payouts of pot with id _potId.

Parameters

NameTypeDescription
_potIdBigNumberishId of the funding pot
_tokenstringAddress of the token, 0x0 value indicates Ether
overrides?CallOverrides-

Returns

Promise<BigNumber>

Inherited from

AugmentedIColony.getFundingPotPayout(uint256,address)


getMembersReputation

getMembersReputation(skillId): Promise<{ addresses: string[] }>

Get all addresses that have reputation for a given skill. If you need the skillId for a certain domain you can use the getDomain function.

Parameters

NameTypeDescription
skillIdBigNumberishThe skill id to get the reputation in

Returns

Promise<{ addresses: string[] }>

All addresses that have a non-zero reputation for the given skill

Inherited from

AugmentedIColony.getMembersReputation


getNonRewardPotsTotal

getNonRewardPotsTotal(_token, overrides?): Promise<BigNumber>

Get the total amount of tokens _token minus amount reserved to be paid to the reputation and token holders as rewards.

Parameters

NameTypeDescription
_tokenstringAddress of the token, 0x0 value indicates Ether
overrides?CallOverrides-

Returns

Promise<BigNumber>

Inherited from

AugmentedIColony.getNonRewardPotsTotal


getNonRewardPotsTotal(address)

getNonRewardPotsTotal(address)(_token, overrides?): Promise<BigNumber>

Get the total amount of tokens _token minus amount reserved to be paid to the reputation and token holders as rewards.

Parameters

NameTypeDescription
_tokenstringAddress of the token, 0x0 value indicates Ether
overrides?CallOverrides-

Returns

Promise<BigNumber>

Inherited from

AugmentedIColony.getNonRewardPotsTotal(address)


getObligation

getObligation(_user, _obligator, _domainId, overrides?): Promise<BigNumber>

View an obligation of tokens.

Parameters

NameTypeDescription
_userstringUser whose tokens are obligated.
_obligatorstringAddress of the account who obligated us.
_domainIdBigNumberishDomain in which we are obligated.
overrides?CallOverrides-

Returns

Promise<BigNumber>

Inherited from

AugmentedIColony.getObligation


getObligation(address,address,uint256)

getObligation(address,address,uint256)(_user, _obligator, _domainId, overrides?): Promise<BigNumber>

View an obligation of tokens.

Parameters

NameTypeDescription
_userstringUser whose tokens are obligated.
_obligatorstringAddress of the account who obligated us.
_domainIdBigNumberishDomain in which we are obligated.
overrides?CallOverrides-

Returns

Promise<BigNumber>

Inherited from

AugmentedIColony.getObligation(address,address,uint256)


getPayment

getPayment(_id, overrides?): Promise<PaymentStructOutput>

Returns an exiting payment.

Parameters

NameTypeDescription
_idBigNumberishPayment identifier
overrides?CallOverrides-

Returns

Promise<PaymentStructOutput>

Inherited from

AugmentedIColony.getPayment


getPayment(uint256)

getPayment(uint256)(_id, overrides?): Promise<PaymentStructOutput>

Returns an exiting payment.

Parameters

NameTypeDescription
_idBigNumberishPayment identifier
overrides?CallOverrides-

Returns

Promise<PaymentStructOutput>

Inherited from

AugmentedIColony.getPayment(uint256)


getPaymentCount

getPaymentCount(overrides?): Promise<BigNumber>

Get the number of payments in the colony.

Parameters

NameType
overrides?CallOverrides

Returns

Promise<BigNumber>

Inherited from

AugmentedIColony.getPaymentCount


getPaymentCount()

getPaymentCount()(overrides?): Promise<BigNumber>

Get the number of payments in the colony.

Parameters

NameType
overrides?CallOverrides

Returns

Promise<BigNumber>

Inherited from

AugmentedIColony.getPaymentCount()


getReputation

getReputation(skillId, address, customRootHash?): Promise<{ branchMask: string ; key: string ; reputationAmount: BigNumber ; siblings: string[] ; value: string }>

Get the reputation for an address and a certain skill. If you need the skillId for a certain domain you can use the getDomain function.

Remarks

This function also retrieves the proofs (branchMask, siblings) that are needed to verify the reputation on chain. If you don't need to do that (e.g. in order to proof the reputation when calling a contract method), you should probably just use the getReputationWithoutProofs method as it requires fewer computations

Parameters

NameTypeDescription
skillIdBigNumberishThe skill id to get the addresses reputation in
addressstringWallet address to retrieve the reputation of
customRootHash?stringThe customRootHash can be set to retrieve the reputation at a certain block time in the past

Returns

Promise<{ branchMask: string ; key: string ; reputationAmount: BigNumber ; siblings: string[] ; value: string }>

The reputation amount as well as the two proofs that are needed to verify the reputation on chain

Inherited from

AugmentedIColony.getReputation


getReputationAcrossDomains

getReputationAcrossDomains(address, customRootHash?): Promise<{ domainId: number ; reputationAmount?: BigNumberish ; skillId: number }[]>

Get the reputation for an address across all domains in a Colony.

Parameters

NameTypeDescription
addressstringWallet address to retrieve the reputation of
customRootHash?stringThe customRootHash can be set to retrieve the reputation at a certain block time in the past

Returns

Promise<{ domainId: number ; reputationAmount?: BigNumberish ; skillId: number }[]>

The reputation amount

Inherited from

AugmentedIColony.getReputationAcrossDomains


getReputationWithoutProofs

getReputationWithoutProofs(skillId, address, customRootHash?): Promise<{ key: string ; reputationAmount: BigNumber ; value: string }>

Get the reputation for an address and a certain skill. If you need the skillId for a certain domain you can use the getDomain function.

Parameters

NameTypeDescription
skillIdBigNumberishThe skill id to get the addresses reputation in
addressstringWallet address to retrieve the reputation of
customRootHash?stringThe customRootHash can be set to retrieve the reputation at a certain block time in the past

Returns

Promise<{ key: string ; reputationAmount: BigNumber ; value: string }>

The reputation amount

Inherited from

AugmentedIColony.getReputationWithoutProofs


getRewardInverse

getRewardInverse(overrides?): Promise<BigNumber>

Return 1 / the reward to pay out from revenue. e.g. if the fee is 1% (or 0.01), return 100.

Parameters

NameType
overrides?CallOverrides

Returns

Promise<BigNumber>

Inherited from

AugmentedIColony.getRewardInverse


getRewardInverse()

getRewardInverse()(overrides?): Promise<BigNumber>

Return 1 / the reward to pay out from revenue. e.g. if the fee is 1% (or 0.01), return 100.

Parameters

NameType
overrides?CallOverrides

Returns

Promise<BigNumber>

Inherited from

AugmentedIColony.getRewardInverse()


getRewardPayoutInfo

getRewardPayoutInfo(_payoutId, overrides?): Promise<RewardPayoutCycleStructOutput>

Get useful information about specific reward payout.

Parameters

NameTypeDescription
_payoutIdBigNumberishId of the reward payout
overrides?CallOverrides-

Returns

Promise<RewardPayoutCycleStructOutput>

Inherited from

AugmentedIColony.getRewardPayoutInfo


getRewardPayoutInfo(uint256)

getRewardPayoutInfo(uint256)(_payoutId, overrides?): Promise<RewardPayoutCycleStructOutput>

Get useful information about specific reward payout.

Parameters

NameTypeDescription
_payoutIdBigNumberishId of the reward payout
overrides?CallOverrides-

Returns

Promise<RewardPayoutCycleStructOutput>

Inherited from

AugmentedIColony.getRewardPayoutInfo(uint256)


getTask

getTask(_id, overrides?): Promise<[string, string, number, BigNumber, BigNumber, BigNumber, BigNumber, BigNumber[]] & { completionTimestamp: BigNumber ; deliverableHash: string ; domainId: BigNumber ; dueDate: BigNumber ; fundingPotId: BigNumber ; skillIds: BigNumber[] ; specificationHash: string ; status: number }>

Get a task with id _id

Parameters

NameTypeDescription
_idBigNumberishId of the task
overrides?CallOverrides-

Returns

Promise<[string, string, number, BigNumber, BigNumber, BigNumber, BigNumber, BigNumber[]] & { completionTimestamp: BigNumber ; deliverableHash: string ; domainId: BigNumber ; dueDate: BigNumber ; fundingPotId: BigNumber ; skillIds: BigNumber[] ; specificationHash: string ; status: number }>

Inherited from

AugmentedIColony.getTask


getTask(uint256)

getTask(uint256)(_id, overrides?): Promise<[string, string, number, BigNumber, BigNumber, BigNumber, BigNumber, BigNumber[]] & { completionTimestamp: BigNumber ; deliverableHash: string ; domainId: BigNumber ; dueDate: BigNumber ; fundingPotId: BigNumber ; skillIds: BigNumber[] ; specificationHash: string ; status: number }>

Get a task with id _id

Parameters

NameTypeDescription
_idBigNumberishId of the task
overrides?CallOverrides-

Returns

Promise<[string, string, number, BigNumber, BigNumber, BigNumber, BigNumber, BigNumber[]] & { completionTimestamp: BigNumber ; deliverableHash: string ; domainId: BigNumber ; dueDate: BigNumber ; fundingPotId: BigNumber ; skillIds: BigNumber[] ; specificationHash: string ; status: number }>

Inherited from

AugmentedIColony.getTask(uint256)


getTaskChangeNonce

getTaskChangeNonce(_id, overrides?): Promise<BigNumber>

Starts from 0 and is incremented on every co-reviewed task change via executeTaskChange call.

Parameters

NameTypeDescription
_idBigNumberishId of the task
overrides?CallOverrides-

Returns

Promise<BigNumber>

Inherited from

AugmentedIColony.getTaskChangeNonce


getTaskChangeNonce(uint256)

getTaskChangeNonce(uint256)(_id, overrides?): Promise<BigNumber>

Starts from 0 and is incremented on every co-reviewed task change via executeTaskChange call.

Parameters

NameTypeDescription
_idBigNumberishId of the task
overrides?CallOverrides-

Returns

Promise<BigNumber>

Inherited from

AugmentedIColony.getTaskChangeNonce(uint256)


getTaskCount

getTaskCount(overrides?): Promise<BigNumber>

Get the number of tasks in the colony.

Parameters

NameType
overrides?CallOverrides

Returns

Promise<BigNumber>

Inherited from

AugmentedIColony.getTaskCount


getTaskCount()

getTaskCount()(overrides?): Promise<BigNumber>

Get the number of tasks in the colony.

Parameters

NameType
overrides?CallOverrides

Returns

Promise<BigNumber>

Inherited from

AugmentedIColony.getTaskCount()


getTaskPayout

getTaskPayout(_id, _role, _token, overrides?): Promise<BigNumber>

Get payout amount in _token denomination for role _role in task _id.

Parameters

NameTypeDescription
_idBigNumberishId of the task
_roleBigNumberishId of the role, as defined in TaskRole enum
_tokenstringAddress of the token, 0x0 value indicates Ether
overrides?CallOverrides-

Returns

Promise<BigNumber>

Inherited from

AugmentedIColony.getTaskPayout


getTaskPayout(uint256,uint8,address)

getTaskPayout(uint256,uint8,address)(_id, _role, _token, overrides?): Promise<BigNumber>

Get payout amount in _token denomination for role _role in task _id.

Parameters

NameTypeDescription
_idBigNumberishId of the task
_roleBigNumberishId of the role, as defined in TaskRole enum
_tokenstringAddress of the token, 0x0 value indicates Ether
overrides?CallOverrides-

Returns

Promise<BigNumber>

Inherited from

AugmentedIColony.getTaskPayout(uint256,uint8,address)


getTaskRole

getTaskRole(_id, _role, overrides?): Promise<RoleStructOutput>

Get the Role properties back for role _role in task _id.

Parameters

NameTypeDescription
_idBigNumberishId of the task
_roleBigNumberishId of the role, as defined in TaskRole enum
overrides?CallOverrides-

Returns

Promise<RoleStructOutput>

Inherited from

AugmentedIColony.getTaskRole


getTaskRole(uint256,uint8)

getTaskRole(uint256,uint8)(_id, _role, overrides?): Promise<RoleStructOutput>

Get the Role properties back for role _role in task _id.

Parameters

NameTypeDescription
_idBigNumberishId of the task
_roleBigNumberishId of the role, as defined in TaskRole enum
overrides?CallOverrides-

Returns

Promise<RoleStructOutput>

Inherited from

AugmentedIColony.getTaskRole(uint256,uint8)


getTaskWorkRatingSecret

getTaskWorkRatingSecret(_id, _role, overrides?): Promise<string>

Get the rating secret submitted for role _role in task _id

Parameters

NameTypeDescription
_idBigNumberishId of the task
_roleBigNumberishId of the role, as defined in TaskRole enum
overrides?CallOverrides-

Returns

Promise<string>

Inherited from

AugmentedIColony.getTaskWorkRatingSecret


getTaskWorkRatingSecret(uint256,uint8)

getTaskWorkRatingSecret(uint256,uint8)(_id, _role, overrides?): Promise<string>

Get the rating secret submitted for role _role in task _id

Parameters

NameTypeDescription
_idBigNumberishId of the task
_roleBigNumberishId of the role, as defined in TaskRole enum
overrides?CallOverrides-

Returns

Promise<string>

Inherited from

AugmentedIColony.getTaskWorkRatingSecret(uint256,uint8)


getTaskWorkRatingSecretsInfo

getTaskWorkRatingSecretsInfo(_id, overrides?): Promise<[BigNumber, BigNumber] & { lastSubmittedAt: BigNumber ; nSecrets: BigNumber }>

Get the ColonyStorage.RatingSecrets information for task _id.

Parameters

NameTypeDescription
_idBigNumberishId of the task
overrides?CallOverrides-

Returns

Promise<[BigNumber, BigNumber] & { lastSubmittedAt: BigNumber ; nSecrets: BigNumber }>

Inherited from

AugmentedIColony.getTaskWorkRatingSecretsInfo


getTaskWorkRatingSecretsInfo(uint256)

getTaskWorkRatingSecretsInfo(uint256)(_id, overrides?): Promise<[BigNumber, BigNumber] & { lastSubmittedAt: BigNumber ; nSecrets: BigNumber }>

Get the ColonyStorage.RatingSecrets information for task _id.

Parameters

NameTypeDescription
_idBigNumberishId of the task
overrides?CallOverrides-

Returns

Promise<[BigNumber, BigNumber] & { lastSubmittedAt: BigNumber ; nSecrets: BigNumber }>

Inherited from

AugmentedIColony.getTaskWorkRatingSecretsInfo(uint256)


getToken

getToken(overrides?): Promise<string>

Get the colony token.

Parameters

NameType
overrides?CallOverrides

Returns

Promise<string>

Inherited from

AugmentedIColony.getToken


getToken()

getToken()(overrides?): Promise<string>

Get the colony token.

Parameters

NameType
overrides?CallOverrides

Returns

Promise<string>

Inherited from

AugmentedIColony.getToken()


getTokenApproval

getTokenApproval(token, spender, overrides?): Promise<BigNumber>

Get the current approval amount

Parameters

NameTypeDescription
tokenstringThe address of the token which was approved
spenderstringThe account we have approved
overrides?CallOverrides-

Returns

Promise<BigNumber>

Inherited from

AugmentedIColony.getTokenApproval


getTokenApproval(address,address)

getTokenApproval(address,address)(token, spender, overrides?): Promise<BigNumber>

Get the current approval amount

Parameters

NameTypeDescription
tokenstringThe address of the token which was approved
spenderstringThe account we have approved
overrides?CallOverrides-

Returns

Promise<BigNumber>

Inherited from

AugmentedIColony.getTokenApproval(address,address)


getTotalTokenApproval

getTotalTokenApproval(token, overrides?): Promise<BigNumber>

Get the current total approval amount across all spenders

Parameters

NameTypeDescription
tokenstringThe address of the token which was approved
overrides?CallOverrides-

Returns

Promise<BigNumber>

Inherited from

AugmentedIColony.getTotalTokenApproval


getTotalTokenApproval(address)

getTotalTokenApproval(address)(token, overrides?): Promise<BigNumber>

Get the current total approval amount across all spenders

Parameters

NameTypeDescription
tokenstringThe address of the token which was approved
overrides?CallOverrides-

Returns

Promise<BigNumber>

Inherited from

AugmentedIColony.getTotalTokenApproval(address)


getUserRoles

getUserRoles(_user, _domain, overrides?): Promise<string>

Gets the bytes32 representation of the roles for a user in a given domain

Parameters

NameTypeDescription
_userstringThe user whose roles we want to get
_domainBigNumberishThe domain we want to get roles in
overrides?CallOverrides-

Returns

Promise<string>

Inherited from

AugmentedIColony.getUserRoles


getUserRoles(address,uint256)

getUserRoles(address,uint256)(_user, _domain, overrides?): Promise<string>

Gets the bytes32 representation of the roles for a user in a given domain

Parameters

NameTypeDescription
_userstringThe user whose roles we want to get
_domainBigNumberishThe domain we want to get roles in
overrides?CallOverrides-

Returns

Promise<string>

Inherited from

AugmentedIColony.getUserRoles(address,uint256)


hasInheritedUserRole

hasInheritedUserRole(_user, _domainId, _role, _childSkillIndex, _childDomainId, overrides?): Promise<boolean>

Check whether a given user has a given role for the colony, in a child domain. Calls the function of the same name on the colony's authority contract and an internal inheritence validator function

Parameters

NameTypeDescription
_userstringThe user whose role we want to check
_domainIdBigNumberishDomain in which the caller has the role
_roleBigNumberishThe role we want to check for
_childSkillIndexBigNumberishThe index that the _childDomainId is relative to _domainId
_childDomainIdBigNumberishThe domain where we want to use the role
overrides?CallOverrides-

Returns

Promise<boolean>

Inherited from

AugmentedIColony.hasInheritedUserRole


hasInheritedUserRole(address,uint256,uint8,uint256,uint256)

hasInheritedUserRole(address,uint256,uint8,uint256,uint256)(_user, _domainId, _role, _childSkillIndex, _childDomainId, overrides?): Promise<boolean>

Check whether a given user has a given role for the colony, in a child domain. Calls the function of the same name on the colony's authority contract and an internal inheritence validator function

Parameters

NameTypeDescription
_userstringThe user whose role we want to check
_domainIdBigNumberishDomain in which the caller has the role
_roleBigNumberishThe role we want to check for
_childSkillIndexBigNumberishThe index that the _childDomainId is relative to _domainId
_childDomainIdBigNumberishThe domain where we want to use the role
overrides?CallOverrides-

Returns

Promise<boolean>

Inherited from

AugmentedIColony.hasInheritedUserRole(address,uint256,uint8,uint256,uint256)


hasInheritedUserRoleWithProofs

hasInheritedUserRoleWithProofs(_user, _domainId, _role, overrides?): Promise<boolean>

Same as hasInheritedUserRole, but let colonyJS figure out the permission proofs for you. Always prefer this method, except when you have good reason not to.

Parameters

NameTypeDescription
_userstringThe user whose role we want to check
_domainIdBigNumberishDomain in which the caller has the role
_roleBigNumberishThe role we want to check for
overrides?TxOverrides-

Returns

Promise<boolean>

Inherited from

ColonyAugmentsV4.hasInheritedUserRoleWithProofs


hasUserRole

hasUserRole(_user, _domainId, _role, overrides?): Promise<boolean>

Check whether a given user has a given role for the colony. Calls the function of the same name on the colony's authority contract.

Parameters

NameTypeDescription
_userstringThe user whose role we want to check
_domainIdBigNumberishThe domain where we want to check for the role
_roleBigNumberishThe role we want to check for
overrides?CallOverrides-

Returns

Promise<boolean>

Inherited from

AugmentedIColony.hasUserRole


hasUserRole(address,uint256,uint8)

hasUserRole(address,uint256,uint8)(_user, _domainId, _role, overrides?): Promise<boolean>

Check whether a given user has a given role for the colony. Calls the function of the same name on the colony's authority contract.

Parameters

NameTypeDescription
_userstringThe user whose role we want to check
_domainIdBigNumberishThe domain where we want to check for the role
_roleBigNumberishThe role we want to check for
overrides?CallOverrides-

Returns

Promise<boolean>

Inherited from

AugmentedIColony.hasUserRole(address,uint256,uint8)


initialiseColony

initialiseColony(_colonyNetworkAddress, _token, overrides?): Promise<ContractTransaction>

Sets the reward inverse to the uint max 2**256 - 1. Called once when the colony is created to initialise certain storage slot values.

Parameters

NameTypeDescription
_colonyNetworkAddressstringAddress of the colony network
_tokenstringAddress of the colony ERC20 Token
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.initialiseColony


initialiseColony(address,address)

initialiseColony(address,address)(_colonyNetworkAddress, _token, overrides?): Promise<ContractTransaction>

Sets the reward inverse to the uint max 2**256 - 1. Called once when the colony is created to initialise certain storage slot values.

Parameters

NameTypeDescription
_colonyNetworkAddressstringAddress of the colony network
_tokenstringAddress of the colony ERC20 Token
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.initialiseColony(address,address)


installExtension

installExtension(extensionId, version, overrides?): Promise<ContractTransaction>

Install an extension to the colony. Secured function to authorised members.

Parameters

NameTypeDescription
extensionIdBytesLikekeccak256 hash of the extension name, used as an indentifier
versionBigNumberishThe new extension version to install
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.installExtension


installExtension(bytes32,uint256)

installExtension(bytes32,uint256)(extensionId, version, overrides?): Promise<ContractTransaction>

Install an extension to the colony. Secured function to authorised members.

Parameters

NameTypeDescription
extensionIdBytesLikekeccak256 hash of the extension name, used as an indentifier
versionBigNumberishThe new extension version to install
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.installExtension(bytes32,uint256)


installExtensionChecked

installExtensionChecked(extension, version?, overrides?): Promise<ContractTransaction>

Similar to installExtension, but first check whether the desired extension can be installed in this Colony Always prefer this method, except when you have good reason not to.

Parameters

NameTypeDescription
extensionExtensionA Extension name
version?numberThe desired version number of the extension you wish to install
overrides?TxOverrides-

Returns

Promise<ContractTransaction>

Inherited from

ColonyAugmentsV5.installExtensionChecked


isInRecoveryMode

isInRecoveryMode(overrides?): Promise<boolean>

Is colony network in recovery mode.

Parameters

NameType
overrides?CallOverrides

Returns

Promise<boolean>

Inherited from

AugmentedIColony.isInRecoveryMode


isInRecoveryMode()

isInRecoveryMode()(overrides?): Promise<boolean>

Is colony network in recovery mode.

Parameters

NameType
overrides?CallOverrides

Returns

Promise<boolean>

Inherited from

AugmentedIColony.isInRecoveryMode()


listenerCount

listenerCount(eventName?): number

Parameters

NameType
eventName?string | EventFilter

Returns

number

Inherited from

AugmentedIColony.listenerCount


listeners

listeners<TEvent>(eventFilter?): TypedListener<TEvent>[]

Type parameters

NameType
TEventextends TypedEvent<any, any, TEvent>

Parameters

NameType
eventFilter?TypedEventFilter<TEvent>

Returns

TypedListener<TEvent>[]

Inherited from

AugmentedIColony.listeners

listeners(eventName?): Listener[]

Parameters

NameType
eventName?string

Returns

Listener[]

Inherited from

AugmentedIColony.listeners


lockExpenditure

lockExpenditure(_id, overrides?): Promise<ContractTransaction>

Locks the expenditure and prevents further editing. Can only be called by expenditure owner.

Parameters

NameTypeDescription
_idBigNumberishExpenditure identifier
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.lockExpenditure


lockExpenditure(uint256)

lockExpenditure(uint256)(_id, overrides?): Promise<ContractTransaction>

Locks the expenditure and prevents further editing. Can only be called by expenditure owner.

Parameters

NameTypeDescription
_idBigNumberishExpenditure identifier
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.lockExpenditure(uint256)


lockToken

lockToken(overrides?): Promise<ContractTransaction>

Lock the colony's token. Can only be called by a network-managed extension.

Parameters

NameType
overrides?Overrides & { from?: string }

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.lockToken


lockToken()

lockToken()(overrides?): Promise<ContractTransaction>

Lock the colony's token. Can only be called by a network-managed extension.

Parameters

NameType
overrides?Overrides & { from?: string }

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.lockToken()


makeArbitraryTransaction

makeArbitraryTransaction(_to, _action, overrides?): Promise<ContractTransaction>

Execute arbitrary transaction on behalf of the Colony DEPRECATED

Parameters

NameTypeDescription
_tostringContract to receive the function call (cannot be this contract, network or token locking)
_actionBytesLikeBytes array encoding the function call and arguments
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.makeArbitraryTransaction


makeArbitraryTransaction(address,bytes)

makeArbitraryTransaction(address,bytes)(_to, _action, overrides?): Promise<ContractTransaction>

Execute arbitrary transaction on behalf of the Colony DEPRECATED

Parameters

NameTypeDescription
_tostringContract to receive the function call (cannot be this contract, network or token locking)
_actionBytesLikeBytes array encoding the function call and arguments
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.makeArbitraryTransaction(address,bytes)


makeArbitraryTransactions

makeArbitraryTransactions(_targets, _actions, _strict, overrides?): Promise<ContractTransaction>

Execute arbitrary transactions on behalf of the Colony in series

Parameters

NameTypeDescription
_targetsstring[]Array of addressed to be targeted
_actionsBytesLike[]Array of Bytes arrays encoding the function calls and arguments
_strictbooleanBoolean indicating whether if one transaction fails, the whole call to this function should fail.
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.makeArbitraryTransactions


makeArbitraryTransactions(address[],bytes[],bool)

makeArbitraryTransactions(address[],bytes[],bool)(_targets, _actions, _strict, overrides?): Promise<ContractTransaction>

Execute arbitrary transactions on behalf of the Colony in series

Parameters

NameTypeDescription
_targetsstring[]Array of addressed to be targeted
_actionsBytesLike[]Array of Bytes arrays encoding the function calls and arguments
_strictbooleanBoolean indicating whether if one transaction fails, the whole call to this function should fail.
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.makeArbitraryTransactions(address[],bytes[],bool)


makeExpenditure

makeExpenditure(_permissionDomainId, _childSkillIndex, _domainId, overrides?): Promise<ContractTransaction>

Add a new expenditure in the colony. Secured function to authorised members.

Parameters

NameTypeDescription
_permissionDomainIdBigNumberishThe domainId in which I have the permission to take this action
_childSkillIndexBigNumberishThe index that the _domainId is relative to _permissionDomainId, (only used if _permissionDomainId is different to _domainId)
_domainIdBigNumberishThe domain where the expenditure belongs
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.makeExpenditure


makeExpenditure(uint256,uint256,uint256)

makeExpenditure(uint256,uint256,uint256)(_permissionDomainId, _childSkillIndex, _domainId, overrides?): Promise<ContractTransaction>

Add a new expenditure in the colony. Secured function to authorised members.

Parameters

NameTypeDescription
_permissionDomainIdBigNumberishThe domainId in which I have the permission to take this action
_childSkillIndexBigNumberishThe index that the _domainId is relative to _permissionDomainId, (only used if _permissionDomainId is different to _domainId)
_domainIdBigNumberishThe domain where the expenditure belongs
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.makeExpenditure(uint256,uint256,uint256)


makeExpenditureWithProofs

makeExpenditureWithProofs(_domainId, overrides?): Promise<ContractTransaction>

Same as makeExpenditure, but let colonyJS figure out the permission proofs for you. Always prefer this method, except when you have good reason not to.

Parameters

NameTypeDescription
_domainIdBigNumberishThe domain where the expenditure belongs
overrides?TxOverrides-

Returns

Promise<ContractTransaction>

Inherited from

ColonyAugmentsV4.makeExpenditureWithProofs


makeSingleArbitraryTransaction

makeSingleArbitraryTransaction(_target, _action, overrides?): Promise<ContractTransaction>

Only callable by the colony itself. If you wish to use this functionality, you should use the makeAbitraryTransactions function Executes a single arbitrary transaction

Parameters

NameTypeDescription
_targetstringContract to receive the function call
_actionBytesLikeBytes array encoding the function call and arguments
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.makeSingleArbitraryTransaction


makeSingleArbitraryTransaction(address,bytes)

makeSingleArbitraryTransaction(address,bytes)(_target, _action, overrides?): Promise<ContractTransaction>

Only callable by the colony itself. If you wish to use this functionality, you should use the makeAbitraryTransactions function Executes a single arbitrary transaction

Parameters

NameTypeDescription
_targetstringContract to receive the function call
_actionBytesLikeBytes array encoding the function call and arguments
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.makeSingleArbitraryTransaction(address,bytes)


makeTask

makeTask(_permissionDomainId, _childSkillIndex, _specificationHash, _domainId, _skillId, _dueDate, overrides?): Promise<ContractTransaction>

Make a new task in the colony. Secured function to authorised members.

Parameters

NameTypeDescription
_permissionDomainIdBigNumberishThe domainId in which I have the permission to take this action
_childSkillIndexBigNumberishThe index that the _domainId is relative to _permissionDomainId
_specificationHashBytesLikeDatabase identifier where the task specification is stored
_domainIdBigNumberishThe domain where the task belongs
_skillIdBigNumberishThe skill associated with the task, can set to 0 for no-op
_dueDateBigNumberishThe due date of the task, can set to 0 for no-op
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.makeTask


makeTask(uint256,uint256,bytes32,uint256,uint256,uint256)

makeTask(uint256,uint256,bytes32,uint256,uint256,uint256)(_permissionDomainId, _childSkillIndex, _specificationHash, _domainId, _skillId, _dueDate, overrides?): Promise<ContractTransaction>

Make a new task in the colony. Secured function to authorised members.

Parameters

NameTypeDescription
_permissionDomainIdBigNumberishThe domainId in which I have the permission to take this action
_childSkillIndexBigNumberishThe index that the _domainId is relative to _permissionDomainId
_specificationHashBytesLikeDatabase identifier where the task specification is stored
_domainIdBigNumberishThe domain where the task belongs
_skillIdBigNumberishThe skill associated with the task, can set to 0 for no-op
_dueDateBigNumberishThe due date of the task, can set to 0 for no-op
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.makeTask(uint256,uint256,bytes32,uint256,uint256,uint256)


makeTaskWithProofs

makeTaskWithProofs(_specificationHash, _domainId, _skillId, _dueDate, overrides?): Promise<ContractTransaction>

Same as makeTask, but let colonyJS figure out the permission proofs for you. Always prefer this method, except when you have good reason not to.

Parameters

NameTypeDescription
_specificationHashBytesLikeDatabase identifier where the task specification is stored
_domainIdBigNumberishThe domain where the task belongs
_skillIdBigNumberishThe skill associated with the task, can set to 0 for no-op
_dueDateBigNumberishThe due date of the task, can set to 0 for no-op
overrides?TxOverrides-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.makeTaskWithProofs


mintTokens

mintTokens(_wad, overrides?): Promise<ContractTransaction>

Mint _wad amount of colony tokens. Secured function to authorised members.

Parameters

NameTypeDescription
_wadBigNumberishAmount to mint
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.mintTokens


mintTokens(uint256)

mintTokens(uint256)(_wad, overrides?): Promise<ContractTransaction>

Mint _wad amount of colony tokens. Secured function to authorised members.

Parameters

NameTypeDescription
_wadBigNumberishAmount to mint
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.mintTokens(uint256)


mintTokensFor

mintTokensFor(_guy, _wad, overrides?): Promise<ContractTransaction>

Mint _wad amount of colony tokens and send to _guy. Secured function to authorised members.

Parameters

NameTypeDescription
_guystringRecipient of new tokens
_wadBigNumberishAmount to mint
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.mintTokensFor


mintTokensFor(address,uint256)

mintTokensFor(address,uint256)(_guy, _wad, overrides?): Promise<ContractTransaction>

Mint _wad amount of colony tokens and send to _guy. Secured function to authorised members.

Parameters

NameTypeDescription
_guystringRecipient of new tokens
_wadBigNumberishAmount to mint
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.mintTokensFor(address,uint256)


moveFundsBetweenPots(uint256,uint256,uint256,uint256,uint256,uint256,address)

moveFundsBetweenPots(uint256,uint256,uint256,uint256,uint256,uint256,address)(_permissionDomainId, _fromChildSkillIndex, _toChildSkillIndex, _fromPot, _toPot, _amount, _token, overrides?): Promise<ContractTransaction>

DEPRECATEDMove a given amount: _amount of _token funds from funding pot with id _fromPot to one with id _toPot.

Parameters

NameTypeDescription
_permissionDomainIdBigNumberishThe domainId in which I have the permission to take this action
_fromChildSkillIndexBigNumberishThe child index in _permissionDomainId where we can find the domain for _fromPotId
_toChildSkillIndexBigNumberishThe child index in _permissionDomainId where we can find the domain for _toPotId
_fromPotBigNumberishFunding pot id providing the funds
_toPotBigNumberishFunding pot id receiving the funds
_amountBigNumberishAmount of funds
_tokenstringAddress of the token, 0x0 value indicates Ether
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.moveFundsBetweenPots(uint256,uint256,uint256,uint256,uint256,uint256,address)


moveFundsBetweenPots(uint256,uint256,uint256,uint256,uint256,uint256,uint256,uint256,address)

moveFundsBetweenPots(uint256,uint256,uint256,uint256,uint256,uint256,uint256,uint256,address)(_permissionDomainId, _childSkillIndex, _domainId, _fromChildSkillIndex, _toChildSkillIndex, _fromPot, _toPot, _amount, _token, overrides?): Promise<ContractTransaction>

Move a given amount: _amount of _token funds from funding pot with id _fromPot to one with id _toPot.

Parameters

NameTypeDescription
_permissionDomainIdBigNumberishThe domainId in which I have the permission to take this action
_childSkillIndexBigNumberishThe child index in _permissionDomainId where I will be taking this action
_domainIdBigNumberishThe domain where I am taking this action, pointed to by _permissionDomainId and _childSkillIndex
_fromChildSkillIndexBigNumberishIn the array of child skills for the skill associated with the domain pointed to by _permissionDomainId + _childSkillIndex, the index of the skill associated with the domain that contains _fromPot
_toChildSkillIndexBigNumberishThe same, but for the _toPot which the funds are being moved to
_fromPotBigNumberishFunding pot id providing the funds
_toPotBigNumberishFunding pot id receiving the funds
_amountBigNumberishAmount of funds
_tokenstringAddress of the token, 0x0 value indicates Ether
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.moveFundsBetweenPots(uint256,uint256,uint256,uint256,uint256,uint256,uint256,uint256,address)


moveFundsBetweenPotsWithProofs(uint256,uint256,uint256,address)

moveFundsBetweenPotsWithProofs(uint256,uint256,uint256,address)(_fromPot, _toPot, _amount, _token, overrides?): Promise<ContractTransaction>

Deprecated

Same as moveFundsBetweenPots(uint256,uint256,uint256,uint256,uint256,uint256,address), but let colonyJS figure out the permission proofs for you. Always prefer this method, except when you have good reason not to.

Parameters

NameTypeDescription
_fromPotBigNumberishFunding pot id providing the funds
_toPotBigNumberishFunding pot id receiving the funds
_amountBigNumberishAmount of funds
_tokenstringAddress of the token, 0x0 value indicates Ether
overrides?TxOverrides-

Returns

Promise<ContractTransaction>

Inherited from

MoveFundsBetweenPotsAugmentsB.moveFundsBetweenPotsWithProofs(uint256,uint256,uint256,address)


moveFundsBetweenPotsWithProofs(uint256,uint256,uint256,uint256,address)

moveFundsBetweenPotsWithProofs(uint256,uint256,uint256,uint256,address)(_domainId, _fromPot, _toPot, _amount, _token, overrides?): Promise<ContractTransaction>

Same as moveFundsBetweenPots(uint256,uint256,uint256,uint256,uint256,uint256,uint256,uint256,address), but let colonyJS figure out the permission proofs for you. Always prefer this method, except when you have good reason not to.

Parameters

NameTypeDescription
_domainIdBigNumberishThe domain where I am taking this action, pointed to by _permissionDomainId and _childSkillIndex
_fromPotBigNumberishFunding pot id providing the funds
_toPotBigNumberishFunding pot id receiving the funds
_amountBigNumberishAmount of funds
_tokenstringAddress of the token, 0x0 value indicates Ether
overrides?TxOverrides-

Returns

Promise<ContractTransaction>

Inherited from

MoveFundsBetweenPotsAugmentsB.moveFundsBetweenPotsWithProofs(uint256,uint256,uint256,uint256,address)


numRecoveryRoles

numRecoveryRoles(overrides?): Promise<BigNumber>

Return number of recovery roles.

Parameters

NameType
overrides?CallOverrides

Returns

Promise<BigNumber>

Inherited from

AugmentedIColony.numRecoveryRoles


numRecoveryRoles()

numRecoveryRoles()(overrides?): Promise<BigNumber>

Return number of recovery roles.

Parameters

NameType
overrides?CallOverrides

Returns

Promise<BigNumber>

Inherited from

AugmentedIColony.numRecoveryRoles()


obligateStake

obligateStake(_user, _domainId, _amount, overrides?): Promise<ContractTransaction>

Obligate the user some amount of tokens as a stake.

Parameters

NameTypeDescription
_userstringAddress of the account we are obligating.
_domainIdBigNumberishDomain in which we are obligating the user.
_amountBigNumberishAmount of internal token we are obligating.
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.obligateStake


obligateStake(address,uint256,uint256)

obligateStake(address,uint256,uint256)(_user, _domainId, _amount, overrides?): Promise<ContractTransaction>

Obligate the user some amount of tokens as a stake.

Parameters

NameTypeDescription
_userstringAddress of the account we are obligating.
_domainIdBigNumberishDomain in which we are obligating the user.
_amountBigNumberishAmount of internal token we are obligating.
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.obligateStake(address,uint256,uint256)


owner

owner(overrides?): Promise<string>

Used for testing. Get the colony owner address. This should be address(0x0) at all times.

Parameters

NameType
overrides?CallOverrides

Returns

Promise<string>

Inherited from

AugmentedIColony.owner


owner()

owner()(overrides?): Promise<string>

Used for testing. Get the colony owner address. This should be address(0x0) at all times.

Parameters

NameType
overrides?CallOverrides

Returns

Promise<string>

Inherited from

AugmentedIColony.owner()


queryFilter

queryFilter<TEvent>(event, fromBlockOrBlockhash?, toBlock?): Promise<TEvent[]>

Type parameters

NameType
TEventextends TypedEvent<any, any, TEvent>

Parameters

NameType
eventTypedEventFilter<TEvent>
fromBlockOrBlockhash?string | number
toBlock?string | number

Returns

Promise<TEvent[]>

Inherited from

AugmentedIColony.queryFilter


registerColonyLabel

registerColonyLabel(colonyName, orbitdb, overrides?): Promise<ContractTransaction>

Register colony's ENS label.

Parameters

NameTypeDescription
colonyNamestringThe label to register.
orbitdbstringThe path of the orbitDB database associated with the colony name
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.registerColonyLabel


registerColonyLabel(string,string)

registerColonyLabel(string,string)(colonyName, orbitdb, overrides?): Promise<ContractTransaction>

Register colony's ENS label.

Parameters

NameTypeDescription
colonyNamestringThe label to register.
orbitdbstringThe path of the orbitDB database associated with the colony name
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.registerColonyLabel(string,string)


removeAllListeners

removeAllListeners<TEvent>(eventFilter): ColonyClientV8

Type parameters

NameType
TEventextends TypedEvent<any, any, TEvent>

Parameters

NameType
eventFilterTypedEventFilter<TEvent>

Returns

ColonyClientV8

Inherited from

AugmentedIColony.removeAllListeners

removeAllListeners(eventName?): ColonyClientV8

Parameters

NameType
eventName?string

Returns

ColonyClientV8

Inherited from

AugmentedIColony.removeAllListeners


removeRecoveryRole

removeRecoveryRole(_user, overrides?): Promise<ContractTransaction>

Remove colony recovery role. Can only be called by root role.

Parameters

NameTypeDescription
_userstringUser we want to remove recovery role from
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.removeRecoveryRole


removeRecoveryRole(address)

removeRecoveryRole(address)(_user, overrides?): Promise<ContractTransaction>

Remove colony recovery role. Can only be called by root role.

Parameters

NameTypeDescription
_userstringUser we want to remove recovery role from
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.removeRecoveryRole(address)


removeTaskEvaluatorRole

removeTaskEvaluatorRole(_id, overrides?): Promise<ContractTransaction>

Removing evaluator role. Agreed between manager and currently assigned evaluator.

Parameters

NameTypeDescription
_idBigNumberishId of the task
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.removeTaskEvaluatorRole


removeTaskEvaluatorRole(uint256)

removeTaskEvaluatorRole(uint256)(_id, overrides?): Promise<ContractTransaction>

Removing evaluator role. Agreed between manager and currently assigned evaluator.

Parameters

NameTypeDescription
_idBigNumberishId of the task
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.removeTaskEvaluatorRole(uint256)


removeTaskWorkerRole

removeTaskWorkerRole(_id, overrides?): Promise<ContractTransaction>

Removing worker role. Agreed between manager and currently assigned worker.

Parameters

NameTypeDescription
_idBigNumberishId of the task
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.removeTaskWorkerRole


removeTaskWorkerRole(uint256)

removeTaskWorkerRole(uint256)(_id, overrides?): Promise<ContractTransaction>

Removing worker role. Agreed between manager and currently assigned worker.

Parameters

NameTypeDescription
_idBigNumberishId of the task
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.removeTaskWorkerRole(uint256)


revealTaskWorkRating

revealTaskWorkRating(_id, _role, _rating, _salt, overrides?): Promise<ContractTransaction>

Compares the keccak256(_salt, _rating) output with the previously submitted rating secret and if they match, sets the task role properties rated to true and rating to _rating. Reveal the secret rating submitted in IColony.submitTaskWorkRating for task _id and task role with id _role. Allowed within 5 days period starting which whichever is first from either both rating secrets being submitted (via IColony.submitTaskWorkRating) or the 5 day rating period expiring.

Parameters

NameTypeDescription
_idBigNumberishId of the task
_roleBigNumberishId of the role, as defined in TaskRole enum
_ratingBigNumberish0-50 rating score (in increments of 10, .e.g 0, 10, 20, 30, 40 or 50)
_saltBytesLikeSalt value used to generate the rating secret
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.revealTaskWorkRating


revealTaskWorkRating(uint256,uint8,uint8,bytes32)

revealTaskWorkRating(uint256,uint8,uint8,bytes32)(_id, _role, _rating, _salt, overrides?): Promise<ContractTransaction>

Compares the keccak256(_salt, _rating) output with the previously submitted rating secret and if they match, sets the task role properties rated to true and rating to _rating. Reveal the secret rating submitted in IColony.submitTaskWorkRating for task _id and task role with id _role. Allowed within 5 days period starting which whichever is first from either both rating secrets being submitted (via IColony.submitTaskWorkRating) or the 5 day rating period expiring.

Parameters

NameTypeDescription
_idBigNumberishId of the task
_roleBigNumberishId of the role, as defined in TaskRole enum
_ratingBigNumberish0-50 rating score (in increments of 10, .e.g 0, 10, 20, 30, 40 or 50)
_saltBytesLikeSalt value used to generate the rating secret
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.revealTaskWorkRating(uint256,uint8,uint8,bytes32)


setAdministrationRole

setAdministrationRole(_permissionDomainId, _childSkillIndex, _user, _domainId, _setTo, overrides?): Promise<ContractTransaction>

Set new colony admin role. Can be called by root role or architecture role.

Parameters

NameTypeDescription
_permissionDomainIdBigNumberishDomain in which the caller has root/architecture role
_childSkillIndexBigNumberishThe index that the _domainId is relative to _permissionDomainId
_userstringUser we want to give an admin role to
_domainIdBigNumberishDomain in which we are giving user the role
_setTobooleanThe state of the role permission (true assign the permission, false revokes it)
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setAdministrationRole


setAdministrationRole(uint256,uint256,address,uint256,bool)

setAdministrationRole(uint256,uint256,address,uint256,bool)(_permissionDomainId, _childSkillIndex, _user, _domainId, _setTo, overrides?): Promise<ContractTransaction>

Set new colony admin role. Can be called by root role or architecture role.

Parameters

NameTypeDescription
_permissionDomainIdBigNumberishDomain in which the caller has root/architecture role
_childSkillIndexBigNumberishThe index that the _domainId is relative to _permissionDomainId
_userstringUser we want to give an admin role to
_domainIdBigNumberishDomain in which we are giving user the role
_setTobooleanThe state of the role permission (true assign the permission, false revokes it)
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setAdministrationRole(uint256,uint256,address,uint256,bool)


setAdministrationRoleWithProofs

setAdministrationRoleWithProofs(_user, _domainId, _setTo, overrides?): Promise<ContractTransaction>

Same as setAdministrationRole, but let colonyJS figure out the permission proofs for you. Always prefer this method, except when you have good reason not to.

Parameters

NameTypeDescription
_userstringUser we want to give an admin role to
_domainIdBigNumberishDomain in which we are giving user the role
_setTobooleanThe state of the role permission (true assign the permission, false revokes it)
overrides?TxOverrides-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setAdministrationRoleWithProofs


setAllTaskPayouts

setAllTaskPayouts(_id, _token, _managerAmount, _evaluatorAmount, _workerAmount, overrides?): Promise<ContractTransaction>

Can only call if evaluator and worker are unassigned or manager, otherwise need signature. Set _token payout for all roles in task _id to the respective amounts.

Parameters

NameTypeDescription
_idBigNumberishId of the task
_tokenstringAddress of the token, 0x0 value indicates Ether
_managerAmountBigNumberishPayout amount for manager
_evaluatorAmountBigNumberishPayout amount for evaluator
_workerAmountBigNumberishPayout amount for worker
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setAllTaskPayouts


setAllTaskPayouts(uint256,address,uint256,uint256,uint256)

setAllTaskPayouts(uint256,address,uint256,uint256,uint256)(_id, _token, _managerAmount, _evaluatorAmount, _workerAmount, overrides?): Promise<ContractTransaction>

Can only call if evaluator and worker are unassigned or manager, otherwise need signature. Set _token payout for all roles in task _id to the respective amounts.

Parameters

NameTypeDescription
_idBigNumberishId of the task
_tokenstringAddress of the token, 0x0 value indicates Ether
_managerAmountBigNumberishPayout amount for manager
_evaluatorAmountBigNumberishPayout amount for evaluator
_workerAmountBigNumberishPayout amount for worker
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setAllTaskPayouts(uint256,address,uint256,uint256,uint256)


setArbitrationRole

setArbitrationRole(_permissionDomainId, _childSkillIndex, _user, _domainId, _setTo, overrides?): Promise<ContractTransaction>

Set new colony arbitration role. Can be called by root role or architecture role.

Parameters

NameTypeDescription
_permissionDomainIdBigNumberishDomain in which the caller has root role
_childSkillIndexBigNumberishThe index that the _domainId is relative to _permissionDomainId
_userstringUser we want to give an arbitration role to
_domainIdBigNumberishDomain in which we are giving user the role
_setTobooleanThe state of the role permission (true assign the permission, false revokes it)
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setArbitrationRole


setArbitrationRole(uint256,uint256,address,uint256,bool)

setArbitrationRole(uint256,uint256,address,uint256,bool)(_permissionDomainId, _childSkillIndex, _user, _domainId, _setTo, overrides?): Promise<ContractTransaction>

Set new colony arbitration role. Can be called by root role or architecture role.

Parameters

NameTypeDescription
_permissionDomainIdBigNumberishDomain in which the caller has root role
_childSkillIndexBigNumberishThe index that the _domainId is relative to _permissionDomainId
_userstringUser we want to give an arbitration role to
_domainIdBigNumberishDomain in which we are giving user the role
_setTobooleanThe state of the role permission (true assign the permission, false revokes it)
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setArbitrationRole(uint256,uint256,address,uint256,bool)


setArbitrationRoleWithProofs

setArbitrationRoleWithProofs(_user, _domainId, _setTo, overrides?): Promise<ContractTransaction>

Same as setArbitrationRole, but let colonyJS figure out the permission proofs for you. Always prefer this method, except when you have good reason not to.

Parameters

NameTypeDescription
_userstringUser we want to give an arbitration role to
_domainIdBigNumberishDomain in which we are giving user the role
_setTobooleanThe state of the role permission (true assign the permission, false revokes it)
overrides?TxOverrides-

Returns

Promise<ContractTransaction>

Inherited from

ColonyAugmentsV3.setArbitrationRoleWithProofs


setArchitectureRole

setArchitectureRole(_permissionDomainId, _childSkillIndex, _user, _domainId, _setTo, overrides?): Promise<ContractTransaction>

Set new colony architecture role. Can be called by root role or architecture role.

Parameters

NameTypeDescription
_permissionDomainIdBigNumberishDomain in which the caller has root/architecture role
_childSkillIndexBigNumberishThe index that the _domainId is relative to _permissionDomainId
_userstringUser we want to give an architecture role to
_domainIdBigNumberishDomain in which we are giving user the role
_setTobooleanThe state of the role permission (true assign the permission, false revokes it)
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setArchitectureRole


setArchitectureRole(uint256,uint256,address,uint256,bool)

setArchitectureRole(uint256,uint256,address,uint256,bool)(_permissionDomainId, _childSkillIndex, _user, _domainId, _setTo, overrides?): Promise<ContractTransaction>

Set new colony architecture role. Can be called by root role or architecture role.

Parameters

NameTypeDescription
_permissionDomainIdBigNumberishDomain in which the caller has root/architecture role
_childSkillIndexBigNumberishThe index that the _domainId is relative to _permissionDomainId
_userstringUser we want to give an architecture role to
_domainIdBigNumberishDomain in which we are giving user the role
_setTobooleanThe state of the role permission (true assign the permission, false revokes it)
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setArchitectureRole(uint256,uint256,address,uint256,bool)


setArchitectureRoleWithProofs

setArchitectureRoleWithProofs(_user, _domainId, _setTo, overrides?): Promise<ContractTransaction>

Same as setArchitectureRole, but let colonyJS figure out the permission proofs for you. Always prefer this method, except when you have good reason not to.

Parameters

NameTypeDescription
_userstringUser we want to give an architecture role to
_domainIdBigNumberishDomain in which we are giving user the role
_setTobooleanThe state of the role permission (true assign the permission, false revokes it)
overrides?TxOverrides-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setArchitectureRoleWithProofs


setDefaultGlobalClaimDelay

setDefaultGlobalClaimDelay(_globalClaimDelay, overrides?): Promise<ContractTransaction>

Update the default global claim delay for expenditures

Parameters

NameTypeDescription
_globalClaimDelayBigNumberishThe new default global claim delay
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setDefaultGlobalClaimDelay


setDefaultGlobalClaimDelay(uint256)

setDefaultGlobalClaimDelay(uint256)(_globalClaimDelay, overrides?): Promise<ContractTransaction>

Update the default global claim delay for expenditures

Parameters

NameTypeDescription
_globalClaimDelayBigNumberishThe new default global claim delay
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setDefaultGlobalClaimDelay(uint256)


setExpenditureClaimDelay

setExpenditureClaimDelay(_id, _slot, _claimDelay, overrides?): Promise<ContractTransaction>

DeprecatedSets the claim delay on an expenditure slot. Can only be called by expenditure owner.

Parameters

NameTypeDescription
_idBigNumberishExpenditure identifier
_slotBigNumberishNumber of the slot
_claimDelayBigNumberishDuration of time (in seconds) to delay
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setExpenditureClaimDelay


setExpenditureClaimDelay(uint256,uint256,uint256)

setExpenditureClaimDelay(uint256,uint256,uint256)(_id, _slot, _claimDelay, overrides?): Promise<ContractTransaction>

DeprecatedSets the claim delay on an expenditure slot. Can only be called by expenditure owner.

Parameters

NameTypeDescription
_idBigNumberishExpenditure identifier
_slotBigNumberishNumber of the slot
_claimDelayBigNumberishDuration of time (in seconds) to delay
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setExpenditureClaimDelay(uint256,uint256,uint256)


setExpenditureClaimDelays

setExpenditureClaimDelays(_id, _slots, _claimDelays, overrides?): Promise<ContractTransaction>

Sets the claim delays in given expenditure slots. Can only be called by expenditure owner.

Parameters

NameTypeDescription
_idBigNumberishExpenditure identifier
_slotsBigNumberish[]Array of slots to set claim delays
_claimDelaysBigNumberish[]Durations of time (in seconds) to delay
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setExpenditureClaimDelays


setExpenditureClaimDelays(uint256,uint256[],uint256[])

setExpenditureClaimDelays(uint256,uint256[],uint256[])(_id, _slots, _claimDelays, overrides?): Promise<ContractTransaction>

Sets the claim delays in given expenditure slots. Can only be called by expenditure owner.

Parameters

NameTypeDescription
_idBigNumberishExpenditure identifier
_slotsBigNumberish[]Array of slots to set claim delays
_claimDelaysBigNumberish[]Durations of time (in seconds) to delay
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setExpenditureClaimDelays(uint256,uint256[],uint256[])


setExpenditureMetadata(uint256,string)

setExpenditureMetadata(uint256,string)(_id, _metadata, overrides?): Promise<ContractTransaction>

Sets the metadata for an expenditure. Can only be called by expenditure owner.

Parameters

NameTypeDescription
_idBigNumberishId of the expenditure
_metadatastringIPFS hash of the metadata
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setExpenditureMetadata(uint256,string)


setExpenditureMetadata(uint256,uint256,uint256,string)

setExpenditureMetadata(uint256,uint256,uint256,string)(_permissionDomainId, _childSkillIndex, _id, _metadata, overrides?): Promise<ContractTransaction>

Sets the metadata for an expenditure. Can only be called by Arbitration role.

Parameters

NameTypeDescription
_permissionDomainIdBigNumberishThe domainId in which I have the permission to take this action
_childSkillIndexBigNumberishThe index that the _domainId is relative to _permissionDomainId,
_idBigNumberishId of the expenditure
_metadatastringIPFS hash of the metadata
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setExpenditureMetadata(uint256,uint256,uint256,string)


setExpenditurePayout

setExpenditurePayout(_id, _slot, _token, _amount, overrides?): Promise<ContractTransaction>

DeprecatedSet the token payout on an expenditure slot. Can only be called by expenditure owner.

Parameters

NameTypeDescription
_idBigNumberishId of the expenditure
_slotBigNumberishNumber of the slot
_tokenstringAddress of the token, 0x0 value indicates Ether
_amountBigNumberishPayout amount
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setExpenditurePayout


setExpenditurePayout(uint256,uint256,address,uint256)

setExpenditurePayout(uint256,uint256,address,uint256)(_id, _slot, _token, _amount, overrides?): Promise<ContractTransaction>

DeprecatedSet the token payout on an expenditure slot. Can only be called by expenditure owner.

Parameters

NameTypeDescription
_idBigNumberishId of the expenditure
_slotBigNumberishNumber of the slot
_tokenstringAddress of the token, 0x0 value indicates Ether
_amountBigNumberishPayout amount
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setExpenditurePayout(uint256,uint256,address,uint256)


setExpenditurePayoutModifiers

setExpenditurePayoutModifiers(_id, _slots, _payoutModifiers, overrides?): Promise<ContractTransaction>

Sets the payout modifiers in given expenditure slots. Can only be called by expenditure owner.

Parameters

NameTypeDescription
_idBigNumberishExpenditure identifier
_slotsBigNumberish[]Array of slots to set payout modifiers
_payoutModifiersBigNumberish[]Values (between +/- WAD) to modify the payout & reputation bonus
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setExpenditurePayoutModifiers


setExpenditurePayoutModifiers(uint256,uint256[],int256[])

setExpenditurePayoutModifiers(uint256,uint256[],int256[])(_id, _slots, _payoutModifiers, overrides?): Promise<ContractTransaction>

Sets the payout modifiers in given expenditure slots. Can only be called by expenditure owner.

Parameters

NameTypeDescription
_idBigNumberishExpenditure identifier
_slotsBigNumberish[]Array of slots to set payout modifiers
_payoutModifiersBigNumberish[]Values (between +/- WAD) to modify the payout & reputation bonus
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setExpenditurePayoutModifiers(uint256,uint256[],int256[])


setExpenditurePayouts

setExpenditurePayouts(_id, _slots, _token, _amounts, overrides?): Promise<ContractTransaction>

Set the token payouts in given expenditure slots. Can only be called by expenditure owner.

Parameters

NameTypeDescription
_idBigNumberishId of the expenditure
_slotsBigNumberish[]Array of slots to set payouts
_tokenstringAddress of the token, 0x0 value indicates Ether
_amountsBigNumberish[]Payout amounts
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setExpenditurePayouts


setExpenditurePayouts(uint256,uint256[],address,uint256[])

setExpenditurePayouts(uint256,uint256[],address,uint256[])(_id, _slots, _token, _amounts, overrides?): Promise<ContractTransaction>

Set the token payouts in given expenditure slots. Can only be called by expenditure owner.

Parameters

NameTypeDescription
_idBigNumberishId of the expenditure
_slotsBigNumberish[]Array of slots to set payouts
_tokenstringAddress of the token, 0x0 value indicates Ether
_amountsBigNumberish[]Payout amounts
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setExpenditurePayouts(uint256,uint256[],address,uint256[])


setExpenditureRecipient

setExpenditureRecipient(_id, _slot, _recipient, overrides?): Promise<ContractTransaction>

DeprecatedSets the recipient on an expenditure slot. Can only be called by expenditure owner.

Parameters

NameTypeDescription
_idBigNumberishId of the expenditure
_slotBigNumberishSlot for the recipient address
_recipientstringAddress of the recipient
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setExpenditureRecipient


setExpenditureRecipient(uint256,uint256,address)

setExpenditureRecipient(uint256,uint256,address)(_id, _slot, _recipient, overrides?): Promise<ContractTransaction>

DeprecatedSets the recipient on an expenditure slot. Can only be called by expenditure owner.

Parameters

NameTypeDescription
_idBigNumberishId of the expenditure
_slotBigNumberishSlot for the recipient address
_recipientstringAddress of the recipient
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setExpenditureRecipient(uint256,uint256,address)


setExpenditureRecipients

setExpenditureRecipients(_id, _slots, _recipients, overrides?): Promise<ContractTransaction>

Sets the recipients in given expenditure slots. Can only be called by expenditure owner.

Parameters

NameTypeDescription
_idBigNumberishId of the expenditure
_slotsBigNumberish[]Array of slots to set recipients
_recipientsstring[]Addresses of the recipients
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setExpenditureRecipients


setExpenditureRecipients(uint256,uint256[],address[])

setExpenditureRecipients(uint256,uint256[],address[])(_id, _slots, _recipients, overrides?): Promise<ContractTransaction>

Sets the recipients in given expenditure slots. Can only be called by expenditure owner.

Parameters

NameTypeDescription
_idBigNumberishId of the expenditure
_slotsBigNumberish[]Array of slots to set recipients
_recipientsstring[]Addresses of the recipients
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setExpenditureRecipients(uint256,uint256[],address[])


setExpenditureSkill

setExpenditureSkill(_id, _slot, _skillId, overrides?): Promise<ContractTransaction>

DeprecatedSets the skill on an expenditure slot. Can only be called by expenditure owner.

Parameters

NameTypeDescription
_idBigNumberishExpenditure identifier
_slotBigNumberishNumber of the slot
_skillIdBigNumberishId of the new skill to set
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setExpenditureSkill


setExpenditureSkill(uint256,uint256,uint256)

setExpenditureSkill(uint256,uint256,uint256)(_id, _slot, _skillId, overrides?): Promise<ContractTransaction>

DeprecatedSets the skill on an expenditure slot. Can only be called by expenditure owner.

Parameters

NameTypeDescription
_idBigNumberishExpenditure identifier
_slotBigNumberishNumber of the slot
_skillIdBigNumberishId of the new skill to set
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setExpenditureSkill(uint256,uint256,uint256)


setExpenditureSkills

setExpenditureSkills(_id, _slots, _skillIds, overrides?): Promise<ContractTransaction>

Sets the skill on an expenditure slot. Can only be called by expenditure owner.

Parameters

NameTypeDescription
_idBigNumberishExpenditure identifier
_slotsBigNumberish[]Array of slots to set skills
_skillIdsBigNumberish[]Ids of the new skills to set
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setExpenditureSkills


setExpenditureSkills(uint256,uint256[],uint256[])

setExpenditureSkills(uint256,uint256[],uint256[])(_id, _slots, _skillIds, overrides?): Promise<ContractTransaction>

Sets the skill on an expenditure slot. Can only be called by expenditure owner.

Parameters

NameTypeDescription
_idBigNumberishExpenditure identifier
_slotsBigNumberish[]Array of slots to set skills
_skillIdsBigNumberish[]Ids of the new skills to set
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setExpenditureSkills(uint256,uint256[],uint256[])


setExpenditureState

setExpenditureState(_permissionDomainId, _childSkillIndex, _id, _storageSlot, _mask, _keys, _value, overrides?): Promise<ContractTransaction>

Set arbitrary state on an expenditure slot. Can only be called by Arbitration role.

Parameters

NameTypeDescription
_permissionDomainIdBigNumberishThe domainId in which I have the permission to take this action
_childSkillIndexBigNumberishThe index that the _domainId is relative to _permissionDomainId, (only used if _permissionDomainId is different to _domainId)
_idBigNumberishExpenditure identifier
_storageSlotBigNumberishNumber of the top-level storage slot (25, 26, or 27)
_maskboolean[]Array of booleans indicated whether a key is a mapping (F) or an array index (T).
_keysBytesLike[]Array of additional keys (for mappings & arrays)
_valueBytesLikeValue to set at location
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setExpenditureState


setExpenditureState(uint256,uint256,uint256,uint256,bool[],bytes32[],bytes32)

setExpenditureState(uint256,uint256,uint256,uint256,bool[],bytes32[],bytes32)(_permissionDomainId, _childSkillIndex, _id, _storageSlot, _mask, _keys, _value, overrides?): Promise<ContractTransaction>

Set arbitrary state on an expenditure slot. Can only be called by Arbitration role.

Parameters

NameTypeDescription
_permissionDomainIdBigNumberishThe domainId in which I have the permission to take this action
_childSkillIndexBigNumberishThe index that the _domainId is relative to _permissionDomainId, (only used if _permissionDomainId is different to _domainId)
_idBigNumberishExpenditure identifier
_storageSlotBigNumberishNumber of the top-level storage slot (25, 26, or 27)
_maskboolean[]Array of booleans indicated whether a key is a mapping (F) or an array index (T).
_keysBytesLike[]Array of additional keys (for mappings & arrays)
_valueBytesLikeValue to set at location
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setExpenditureState(uint256,uint256,uint256,uint256,bool[],bytes32[],bytes32)


setExpenditureStateWithProofs

setExpenditureStateWithProofs(_id, _storageSlot, _mask, _keys, _value, overrides?): Promise<ContractTransaction>

Same as editDomain, but let colonyJS figure out the permission proofs for you. Always prefer this method, except when you have good reason not to.

Parameters

NameTypeDescription
_idBigNumberishExpenditure identifier
_storageSlotBigNumberishNumber of the top-level storage slot (25, 26, or 27)
_maskboolean[]Array of booleans indicated whether a key is a mapping (F) or an array index (T).
_keysBytesLike[]Array of additional keys (for mappings & arrays)
_valueBytesLikeValue to set at location
overrides?TxOverrides-

Returns

Promise<ContractTransaction>

Inherited from

ColonyAugmentsV5.setExpenditureStateWithProofs


setFundingRole

setFundingRole(_permissionDomainId, _childSkillIndex, _user, _domainId, _setTo, overrides?): Promise<ContractTransaction>

Set new colony funding role. Can be called by root role or architecture role.

Parameters

NameTypeDescription
_permissionDomainIdBigNumberishDomain in which the caller has root/architecture role
_childSkillIndexBigNumberishThe index that the _domainId is relative to _permissionDomainId
_userstringUser we want to give an funding role to
_domainIdBigNumberishDomain in which we are giving user the role
_setTobooleanThe state of the role permission (true assign the permission, false revokes it)
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setFundingRole


setFundingRole(uint256,uint256,address,uint256,bool)

setFundingRole(uint256,uint256,address,uint256,bool)(_permissionDomainId, _childSkillIndex, _user, _domainId, _setTo, overrides?): Promise<ContractTransaction>

Set new colony funding role. Can be called by root role or architecture role.

Parameters

NameTypeDescription
_permissionDomainIdBigNumberishDomain in which the caller has root/architecture role
_childSkillIndexBigNumberishThe index that the _domainId is relative to _permissionDomainId
_userstringUser we want to give an funding role to
_domainIdBigNumberishDomain in which we are giving user the role
_setTobooleanThe state of the role permission (true assign the permission, false revokes it)
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setFundingRole(uint256,uint256,address,uint256,bool)


setFundingRoleWithProofs

setFundingRoleWithProofs(_user, _domainId, _setTo, overrides?): Promise<ContractTransaction>

Same as setFundingRole, but let colonyJS figure out the permission proofs for you. Always prefer this method, except when you have good reason not to.

Parameters

NameTypeDescription
_userstringUser we want to give an funding role to
_domainIdBigNumberishDomain in which we are giving user the role
_setTobooleanThe state of the role permission (true assign the permission, false revokes it)
overrides?TxOverrides-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setFundingRoleWithProofs


setPaymentPayout

setPaymentPayout(_permissionDomainId, _childSkillIndex, _id, _token, _amount, overrides?): Promise<ContractTransaction>

Sets the payout for a given token on an existing payment. Secured function to authorised members.

Parameters

NameTypeDescription
_permissionDomainIdBigNumberishThe domainId in which I have the permission to take this action
_childSkillIndexBigNumberishThe index that the _domainId is relative to _permissionDomainId
_idBigNumberishPayment identifier
_tokenstringAddress of the token, 0x0 value indicates Ether
_amountBigNumberishPayout amount
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setPaymentPayout


setPaymentPayout(uint256,uint256,uint256,address,uint256)

setPaymentPayout(uint256,uint256,uint256,address,uint256)(_permissionDomainId, _childSkillIndex, _id, _token, _amount, overrides?): Promise<ContractTransaction>

Sets the payout for a given token on an existing payment. Secured function to authorised members.

Parameters

NameTypeDescription
_permissionDomainIdBigNumberishThe domainId in which I have the permission to take this action
_childSkillIndexBigNumberishThe index that the _domainId is relative to _permissionDomainId
_idBigNumberishPayment identifier
_tokenstringAddress of the token, 0x0 value indicates Ether
_amountBigNumberishPayout amount
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setPaymentPayout(uint256,uint256,uint256,address,uint256)


setPaymentPayoutWithProofs

setPaymentPayoutWithProofs(_id, _token, _amount, overrides?): Promise<ContractTransaction>

Same as setPaymentPayout, but let colonyJS figure out the permission proofs for you. Always prefer this method, except when you have good reason not to.

Parameters

NameTypeDescription
_idBigNumberishPayment identifier
_tokenBigNumberishAddress of the token, 0x0 value indicates Ether
_amountBigNumberishPayout amount
overrides?TxOverrides-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setPaymentPayoutWithProofs


setPaymentRecipient

setPaymentRecipient(_permissionDomainId, _childSkillIndex, _id, _recipient, overrides?): Promise<ContractTransaction>

Sets the recipient on an existing payment. Secured function to authorised members.

Parameters

NameTypeDescription
_permissionDomainIdBigNumberishThe domainId in which I have the permission to take this action
_childSkillIndexBigNumberishThe index that the _domainId is relative to _permissionDomainId
_idBigNumberishPayment identifier
_recipientstringAddress of the payment recipient
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setPaymentRecipient


setPaymentRecipient(uint256,uint256,uint256,address)

setPaymentRecipient(uint256,uint256,uint256,address)(_permissionDomainId, _childSkillIndex, _id, _recipient, overrides?): Promise<ContractTransaction>

Sets the recipient on an existing payment. Secured function to authorised members.

Parameters

NameTypeDescription
_permissionDomainIdBigNumberishThe domainId in which I have the permission to take this action
_childSkillIndexBigNumberishThe index that the _domainId is relative to _permissionDomainId
_idBigNumberishPayment identifier
_recipientstringAddress of the payment recipient
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setPaymentRecipient(uint256,uint256,uint256,address)


setPaymentRecipientWithProofs

setPaymentRecipientWithProofs(_id, _recipient, overrides?): Promise<ContractTransaction>

Same as setPaymentRecipient, but let colonyJS figure out the permission proofs for you. Always prefer this method, except when you have good reason not to.

Parameters

NameTypeDescription
_idBigNumberishPayment identifier
_recipientstringAddress of the payment recipient
overrides?TxOverrides-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setPaymentRecipientWithProofs


setPaymentSkill

setPaymentSkill(_permissionDomainId, _childSkillIndex, _id, _skillId, overrides?): Promise<ContractTransaction>

Sets the skill on an existing payment. Secured function to authorised members.

Parameters

NameTypeDescription
_permissionDomainIdBigNumberishThe domainId in which I have the permission to take this action
_childSkillIndexBigNumberishThe index that the _domainId is relative to _permissionDomainId
_idBigNumberishPayment identifier
_skillIdBigNumberishId of the new skill to set
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setPaymentSkill


setPaymentSkill(uint256,uint256,uint256,uint256)

setPaymentSkill(uint256,uint256,uint256,uint256)(_permissionDomainId, _childSkillIndex, _id, _skillId, overrides?): Promise<ContractTransaction>

Sets the skill on an existing payment. Secured function to authorised members.

Parameters

NameTypeDescription
_permissionDomainIdBigNumberishThe domainId in which I have the permission to take this action
_childSkillIndexBigNumberishThe index that the _domainId is relative to _permissionDomainId
_idBigNumberishPayment identifier
_skillIdBigNumberishId of the new skill to set
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setPaymentSkill(uint256,uint256,uint256,uint256)


setPaymentSkillWithProofs

setPaymentSkillWithProofs(_id, _skillId, overrides?): Promise<ContractTransaction>

Same as setPaymentSkill, but let colonyJS figure out the permission proofs for you. Always prefer this method, except when you have good reason not to.

Parameters

NameTypeDescription
_idBigNumberishPayment identifier
_skillIdBigNumberishId of the new skill to set
overrides?TxOverrides-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setPaymentSkillWithProofs


setRecoveryRole

setRecoveryRole(_user, overrides?): Promise<ContractTransaction>

Set new colony recovery role. Can be called by root.

Parameters

NameTypeDescription
_userstringUser we want to give a recovery role to
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setRecoveryRole


setRecoveryRole(address)

setRecoveryRole(address)(_user, overrides?): Promise<ContractTransaction>

Set new colony recovery role. Can be called by root.

Parameters

NameTypeDescription
_userstringUser we want to give a recovery role to
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setRecoveryRole(address)


setRewardInverse

setRewardInverse(_rewardInverse, overrides?): Promise<ContractTransaction>

Set the reward inverse to pay out from revenue. e.g. if the fee is 1% (or 0.01), set 100.

Parameters

NameTypeDescription
_rewardInverseBigNumberishThe inverse of the reward
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setRewardInverse


setRewardInverse(uint256)

setRewardInverse(uint256)(_rewardInverse, overrides?): Promise<ContractTransaction>

Set the reward inverse to pay out from revenue. e.g. if the fee is 1% (or 0.01), set 100.

Parameters

NameTypeDescription
_rewardInverseBigNumberishThe inverse of the reward
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setRewardInverse(uint256)


setRootRole

setRootRole(_user, _setTo, overrides?): Promise<ContractTransaction>

Set new colony root role. Can be called by root role only.

Parameters

NameTypeDescription
_userstringUser we want to give an root role to
_setTobooleanThe state of the role permission (true assign the permission, false revokes it)
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setRootRole


setRootRole(address,bool)

setRootRole(address,bool)(_user, _setTo, overrides?): Promise<ContractTransaction>

Set new colony root role. Can be called by root role only.

Parameters

NameTypeDescription
_userstringUser we want to give an root role to
_setTobooleanThe state of the role permission (true assign the permission, false revokes it)
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setRootRole(address,bool)


setStorageSlotRecovery

setStorageSlotRecovery(_slot, _value, overrides?): Promise<ContractTransaction>

certain critical variables are protected from editing in this function Update value of arbitrary storage variable. Can only be called by user with recovery role.

Parameters

NameTypeDescription
_slotBigNumberishUint address of storage slot to be updated
_valueBytesLikeword of data to be set
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setStorageSlotRecovery


setStorageSlotRecovery(uint256,bytes32)

setStorageSlotRecovery(uint256,bytes32)(_slot, _value, overrides?): Promise<ContractTransaction>

certain critical variables are protected from editing in this function Update value of arbitrary storage variable. Can only be called by user with recovery role.

Parameters

NameTypeDescription
_slotBigNumberishUint address of storage slot to be updated
_valueBytesLikeword of data to be set
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setStorageSlotRecovery(uint256,bytes32)


setTaskBrief

setTaskBrief(_id, _specificationHash, overrides?): Promise<ContractTransaction>

Set the hash for the task brief, aka task work specification, which identifies the task brief content in ddb. Allowed before a task is finalized.

Parameters

NameTypeDescription
_idBigNumberishId of the task
_specificationHashBytesLikeUnique hash of the task brief in ddb
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setTaskBrief


setTaskBrief(uint256,bytes32)

setTaskBrief(uint256,bytes32)(_id, _specificationHash, overrides?): Promise<ContractTransaction>

Set the hash for the task brief, aka task work specification, which identifies the task brief content in ddb. Allowed before a task is finalized.

Parameters

NameTypeDescription
_idBigNumberishId of the task
_specificationHashBytesLikeUnique hash of the task brief in ddb
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setTaskBrief(uint256,bytes32)


setTaskDueDate

setTaskDueDate(_id, _dueDate, overrides?): Promise<ContractTransaction>

Set the due date on task _id. Allowed before a task is finalized.

Parameters

NameTypeDescription
_idBigNumberishId of the task
_dueDateBigNumberishDue date as seconds since unix epoch
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setTaskDueDate


setTaskDueDate(uint256,uint256)

setTaskDueDate(uint256,uint256)(_id, _dueDate, overrides?): Promise<ContractTransaction>

Set the due date on task _id. Allowed before a task is finalized.

Parameters

NameTypeDescription
_idBigNumberishId of the task
_dueDateBigNumberishDue date as seconds since unix epoch
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setTaskDueDate(uint256,uint256)


setTaskEvaluatorPayout

setTaskEvaluatorPayout(_id, _token, _amount, overrides?): Promise<ContractTransaction>

Set _token payout for evaluator in task _id to _amount.

Parameters

NameTypeDescription
_idBigNumberishId of the task
_tokenstringAddress of the token, 0x0 value indicates Ether
_amountBigNumberishPayout amount
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setTaskEvaluatorPayout


setTaskEvaluatorPayout(uint256,address,uint256)

setTaskEvaluatorPayout(uint256,address,uint256)(_id, _token, _amount, overrides?): Promise<ContractTransaction>

Set _token payout for evaluator in task _id to _amount.

Parameters

NameTypeDescription
_idBigNumberishId of the task
_tokenstringAddress of the token, 0x0 value indicates Ether
_amountBigNumberishPayout amount
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setTaskEvaluatorPayout(uint256,address,uint256)


setTaskEvaluatorRole

setTaskEvaluatorRole(_id, _user, overrides?): Promise<ContractTransaction>

This function can only be called through executeTaskRoleAssignment. Assigning evaluator role. Can only be set if there is no one currently assigned to be an evaluator. Manager of the task and user we want to assign role to both need to agree. Managers can assign themselves to this role, if there is no one currently assigned to it.

Parameters

NameTypeDescription
_idBigNumberishId of the task
_userstringAddress of the user we want to give a evaluator role to
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setTaskEvaluatorRole


setTaskEvaluatorRole(uint256,address)

setTaskEvaluatorRole(uint256,address)(_id, _user, overrides?): Promise<ContractTransaction>

This function can only be called through executeTaskRoleAssignment. Assigning evaluator role. Can only be set if there is no one currently assigned to be an evaluator. Manager of the task and user we want to assign role to both need to agree. Managers can assign themselves to this role, if there is no one currently assigned to it.

Parameters

NameTypeDescription
_idBigNumberishId of the task
_userstringAddress of the user we want to give a evaluator role to
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setTaskEvaluatorRole(uint256,address)


setTaskManagerPayout

setTaskManagerPayout(_id, _token, _amount, overrides?): Promise<ContractTransaction>

Set _token payout for manager in task _id to _amount.

Parameters

NameTypeDescription
_idBigNumberishId of the task
_tokenstringAddress of the token, 0x0 value indicates Ether
_amountBigNumberishPayout amount
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setTaskManagerPayout


setTaskManagerPayout(uint256,address,uint256)

setTaskManagerPayout(uint256,address,uint256)(_id, _token, _amount, overrides?): Promise<ContractTransaction>

Set _token payout for manager in task _id to _amount.

Parameters

NameTypeDescription
_idBigNumberishId of the task
_tokenstringAddress of the token, 0x0 value indicates Ether
_amountBigNumberishPayout amount
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setTaskManagerPayout(uint256,address,uint256)


setTaskManagerRole

setTaskManagerRole(_id, _user, _permissionDomainId, _childSkillIndex, overrides?): Promise<ContractTransaction>

This function can only be called through executeTaskRoleAssignment. Assigning manager role. Current manager and user we want to assign role to both need to agree. User we want to set here also needs to be an admin. Note that the domain proof data comes at the end here to not interfere with the assembly argument unpacking.

Parameters

NameTypeDescription
_idBigNumberishId of the task
_userstringAddress of the user we want to give a manager role to
_permissionDomainIdBigNumberishThe domain ID in which _user has the Administration permission
_childSkillIndexBigNumberishThe index that the _domainId is relative to _permissionDomainId
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setTaskManagerRole


setTaskManagerRole(uint256,address,uint256,uint256)

setTaskManagerRole(uint256,address,uint256,uint256)(_id, _user, _permissionDomainId, _childSkillIndex, overrides?): Promise<ContractTransaction>

This function can only be called through executeTaskRoleAssignment. Assigning manager role. Current manager and user we want to assign role to both need to agree. User we want to set here also needs to be an admin. Note that the domain proof data comes at the end here to not interfere with the assembly argument unpacking.

Parameters

NameTypeDescription
_idBigNumberishId of the task
_userstringAddress of the user we want to give a manager role to
_permissionDomainIdBigNumberishThe domain ID in which _user has the Administration permission
_childSkillIndexBigNumberishThe index that the _domainId is relative to _permissionDomainId
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setTaskManagerRole(uint256,address,uint256,uint256)


setTaskSkill

setTaskSkill(_id, _skillId, overrides?): Promise<ContractTransaction>

Currently we only allow one skill per task although we have provisioned for an array of skills in Task struct. Allowed before a task is finalized. Set the skill for task _id.

Parameters

NameTypeDescription
_idBigNumberishId of the task
_skillIdBigNumberishId of the skill which has to be a global skill
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setTaskSkill


setTaskSkill(uint256,uint256)

setTaskSkill(uint256,uint256)(_id, _skillId, overrides?): Promise<ContractTransaction>

Currently we only allow one skill per task although we have provisioned for an array of skills in Task struct. Allowed before a task is finalized. Set the skill for task _id.

Parameters

NameTypeDescription
_idBigNumberishId of the task
_skillIdBigNumberishId of the skill which has to be a global skill
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setTaskSkill(uint256,uint256)


setTaskWorkerPayout

setTaskWorkerPayout(_id, _token, _amount, overrides?): Promise<ContractTransaction>

Set _token payout for worker in task _id to _amount.

Parameters

NameTypeDescription
_idBigNumberishId of the task
_tokenstringAddress of the token, 0x0 value indicates Ether
_amountBigNumberishPayout amount
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setTaskWorkerPayout


setTaskWorkerPayout(uint256,address,uint256)

setTaskWorkerPayout(uint256,address,uint256)(_id, _token, _amount, overrides?): Promise<ContractTransaction>

Set _token payout for worker in task _id to _amount.

Parameters

NameTypeDescription
_idBigNumberishId of the task
_tokenstringAddress of the token, 0x0 value indicates Ether
_amountBigNumberishPayout amount
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setTaskWorkerPayout(uint256,address,uint256)


setTaskWorkerRole

setTaskWorkerRole(_id, _user, overrides?): Promise<ContractTransaction>

This function can only be called through executeTaskRoleAssignment. Assigning worker role. Can only be set if there is no one currently assigned to be a worker. Manager of the task and user we want to assign role to both need to agree.

Parameters

NameTypeDescription
_idBigNumberishId of the task
_userstringAddress of the user we want to give a worker role to
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setTaskWorkerRole


setTaskWorkerRole(uint256,address)

setTaskWorkerRole(uint256,address)(_id, _user, overrides?): Promise<ContractTransaction>

This function can only be called through executeTaskRoleAssignment. Assigning worker role. Can only be set if there is no one currently assigned to be a worker. Manager of the task and user we want to assign role to both need to agree.

Parameters

NameTypeDescription
_idBigNumberishId of the task
_userstringAddress of the user we want to give a worker role to
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setTaskWorkerRole(uint256,address)


setUserRoles

setUserRoles(_permissionDomainId, _childSkillIndex, _user, _domainId, _roles, overrides?): Promise<ContractTransaction>

Set several roles in one transaction. Can be called by root role or architecture role.

Parameters

NameTypeDescription
_permissionDomainIdBigNumberishDomain in which the caller has root/architecture role
_childSkillIndexBigNumberishThe index that the _domainId is relative to _permissionDomainId
_userstringUser we want to give a role to
_domainIdBigNumberishDomain in which we are giving user the role
_rolesBytesLikeByte array representing the desired role setting (1 for on, 0 for off)
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setUserRoles


setUserRoles(uint256,uint256,address,uint256,bytes32)

setUserRoles(uint256,uint256,address,uint256,bytes32)(_permissionDomainId, _childSkillIndex, _user, _domainId, _roles, overrides?): Promise<ContractTransaction>

Set several roles in one transaction. Can be called by root role or architecture role.

Parameters

NameTypeDescription
_permissionDomainIdBigNumberishDomain in which the caller has root/architecture role
_childSkillIndexBigNumberishThe index that the _domainId is relative to _permissionDomainId
_userstringUser we want to give a role to
_domainIdBigNumberishDomain in which we are giving user the role
_rolesBytesLikeByte array representing the desired role setting (1 for on, 0 for off)
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.setUserRoles(uint256,uint256,address,uint256,bytes32)


setUserRolesWithProofs

setUserRolesWithProofs(_user, _domainId, _roles, overrides?): Promise<ContractTransaction>

Same as setUserRoles, but let colonyJS figure out the permission proofs for you. Always prefer this method, except when you have good reason not to.

Parameters

NameTypeDescription
_userstringUser we want to give a role to
_domainIdBigNumberishDomain in which we are giving user the role
_rolesBytesLikeByte array representing the desired role setting (1 for on, 0 for off)
overrides?TxOverrides-

Returns

Promise<ContractTransaction>

Inherited from

ColonyAugmentsV5.setUserRolesWithProofs


startNextRewardPayout

startNextRewardPayout(_token, key, value, branchMask, siblings, overrides?): Promise<ContractTransaction>

Start next reward payout for _token. All funds in the reward pot for _token will become unavailable.Add a new payment in the colony. Can only be called by users with root permission. All tokens will be locked, and can be unlocked by calling waiveRewardPayout or claimRewardPayout.

Parameters

NameTypeDescription
_tokenstringAddress of the token used for reward payout
keyBytesLikeSome Reputation hash tree key
valueBytesLikeReputation value
branchMaskBigNumberishThe branchmask of the proof
siblingsBytesLike[]The siblings of the proof
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.startNextRewardPayout


startNextRewardPayout(address,bytes,bytes,uint256,bytes32[])

startNextRewardPayout(address,bytes,bytes,uint256,bytes32[])(_token, key, value, branchMask, siblings, overrides?): Promise<ContractTransaction>

Start next reward payout for _token. All funds in the reward pot for _token will become unavailable.Add a new payment in the colony. Can only be called by users with root permission. All tokens will be locked, and can be unlocked by calling waiveRewardPayout or claimRewardPayout.

Parameters

NameTypeDescription
_tokenstringAddress of the token used for reward payout
keyBytesLikeSome Reputation hash tree key
valueBytesLikeReputation value
branchMaskBigNumberishThe branchmask of the proof
siblingsBytesLike[]The siblings of the proof
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.startNextRewardPayout(address,bytes,bytes,uint256,bytes32[])


submitTaskDeliverable

submitTaskDeliverable(_id, _deliverableHash, overrides?): Promise<ContractTransaction>

Set the task.deliverableHash and task.completionTimestamp properties. Submit the task deliverable, i.e. the output of the work performed for task _id. Submission is allowed only to the assigned worker before the task due date. Submissions cannot be overwritten.

Parameters

NameTypeDescription
_idBigNumberishId of the task
_deliverableHashBytesLikeUnique hash of the task deliverable content in ddb
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.submitTaskDeliverable


submitTaskDeliverable(uint256,bytes32)

submitTaskDeliverable(uint256,bytes32)(_id, _deliverableHash, overrides?): Promise<ContractTransaction>

Set the task.deliverableHash and task.completionTimestamp properties. Submit the task deliverable, i.e. the output of the work performed for task _id. Submission is allowed only to the assigned worker before the task due date. Submissions cannot be overwritten.

Parameters

NameTypeDescription
_idBigNumberishId of the task
_deliverableHashBytesLikeUnique hash of the task deliverable content in ddb
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.submitTaskDeliverable(uint256,bytes32)


submitTaskDeliverableAndRating

submitTaskDeliverableAndRating(_id, _deliverableHash, _ratingSecret, overrides?): Promise<ContractTransaction>

Internally call submitTaskDeliverable and submitTaskWorkRating in sequence. Submit the task deliverable for Worker and rating for Manager.

Parameters

NameTypeDescription
_idBigNumberishId of the task
_deliverableHashBytesLikeUnique hash of the task deliverable content in ddb
_ratingSecretBytesLikeRating secret for manager
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.submitTaskDeliverableAndRating


submitTaskDeliverableAndRating(uint256,bytes32,bytes32)

submitTaskDeliverableAndRating(uint256,bytes32,bytes32)(_id, _deliverableHash, _ratingSecret, overrides?): Promise<ContractTransaction>

Internally call submitTaskDeliverable and submitTaskWorkRating in sequence. Submit the task deliverable for Worker and rating for Manager.

Parameters

NameTypeDescription
_idBigNumberishId of the task
_deliverableHashBytesLikeUnique hash of the task deliverable content in ddb
_ratingSecretBytesLikeRating secret for manager
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.submitTaskDeliverableAndRating(uint256,bytes32,bytes32)


submitTaskWorkRating

submitTaskWorkRating(_id, _role, _ratingSecret, overrides?): Promise<ContractTransaction>

Submit a hashed secret of the rating for work in task _id which was performed by user with task role id _role. Allowed within 5 days period starting which whichever is first from either the deliverable being submitted or the dueDate been reached. Allowed only for evaluator to rate worker and for worker to rate manager performance. Once submitted ratings can not be changed or overwritten.

Parameters

NameTypeDescription
_idBigNumberishId of the task
_roleBigNumberishId of the role, as defined in TaskRole enum
_ratingSecretBytesLikekeccak256 hash of a salt and 0-50 rating score (in increments of 10, .e.g 0, 10, 20, 30, 40 or 50). Can be generated via IColony.generateSecret helper function.
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.submitTaskWorkRating


submitTaskWorkRating(uint256,uint8,bytes32)

submitTaskWorkRating(uint256,uint8,bytes32)(_id, _role, _ratingSecret, overrides?): Promise<ContractTransaction>

Submit a hashed secret of the rating for work in task _id which was performed by user with task role id _role. Allowed within 5 days period starting which whichever is first from either the deliverable being submitted or the dueDate been reached. Allowed only for evaluator to rate worker and for worker to rate manager performance. Once submitted ratings can not be changed or overwritten.

Parameters

NameTypeDescription
_idBigNumberishId of the task
_roleBigNumberishId of the role, as defined in TaskRole enum
_ratingSecretBytesLikekeccak256 hash of a salt and 0-50 rating score (in increments of 10, .e.g 0, 10, 20, 30, 40 or 50). Can be generated via IColony.generateSecret helper function.
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.submitTaskWorkRating(uint256,uint8,bytes32)


transferExpenditure

transferExpenditure(_id, _newOwner, overrides?): Promise<ContractTransaction>

Updates the expenditure owner. Can only be called by expenditure owner.

Parameters

NameTypeDescription
_idBigNumberishExpenditure identifier
_newOwnerstringNew owner of expenditure
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.transferExpenditure


transferExpenditure(uint256,address)

transferExpenditure(uint256,address)(_id, _newOwner, overrides?): Promise<ContractTransaction>

Updates the expenditure owner. Can only be called by expenditure owner.

Parameters

NameTypeDescription
_idBigNumberishExpenditure identifier
_newOwnerstringNew owner of expenditure
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.transferExpenditure(uint256,address)


transferExpenditureViaArbitration

transferExpenditureViaArbitration(_permissionDomainId, _childSkillIndex, _id, _newOwner, overrides?): Promise<ContractTransaction>

This is now deprecated and will be removed in a future version DEPRECATED Updates the expenditure owner. Can only be called by Arbitration role.

Parameters

NameTypeDescription
_permissionDomainIdBigNumberishThe domainId in which I have the permission to take this action
_childSkillIndexBigNumberishThe index that the _domainId is relative to _permissionDomainId, (only used if _permissionDomainId is different to _domainId)
_idBigNumberishExpenditure identifier
_newOwnerstringNew owner of expenditure
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.transferExpenditureViaArbitration


transferExpenditureViaArbitration(uint256,uint256,uint256,address)

transferExpenditureViaArbitration(uint256,uint256,uint256,address)(_permissionDomainId, _childSkillIndex, _id, _newOwner, overrides?): Promise<ContractTransaction>

This is now deprecated and will be removed in a future version DEPRECATED Updates the expenditure owner. Can only be called by Arbitration role.

Parameters

NameTypeDescription
_permissionDomainIdBigNumberishThe domainId in which I have the permission to take this action
_childSkillIndexBigNumberishThe index that the _domainId is relative to _permissionDomainId, (only used if _permissionDomainId is different to _domainId)
_idBigNumberishExpenditure identifier
_newOwnerstringNew owner of expenditure
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.transferExpenditureViaArbitration(uint256,uint256,uint256,address)


transferExpenditureViaArbitrationWithProofs

transferExpenditureViaArbitrationWithProofs(_id, _newOwner, overrides?): Promise<ContractTransaction>

Deprecated

Same as transferExpenditureViaArbitration, but let colonyJS figure out the permission proofs for you. Always prefer this method, except when you have good reason not to.

Parameters

NameTypeDescription
_idBigNumberishExpenditure identifier
_newOwnerstringNew owner of expenditure
overrides?TxOverrides-

Returns

Promise<ContractTransaction>

Inherited from

ColonyAugmentsV4.transferExpenditureViaArbitrationWithProofs


transferStake

transferStake(_permissionDomainId, _childSkillIndex, _obligator, _user, _domainId, _amount, _recipient, overrides?): Promise<ContractTransaction>

Transfer some amount of obligated tokens. Can be called by the arbitration role.

Parameters

NameTypeDescription
_permissionDomainIdBigNumberishThe domainId in which I have the permission to take this action.
_childSkillIndexBigNumberishThe child index in _permissionDomainId where we can find _domainId.
_obligatorstringAddress of the account who set the obligation.
_userstringAddress of the account we are transferring.
_domainIdBigNumberishDomain in which we are transferring the tokens.
_amountBigNumberishAmount of internal token we are transferring.
_recipientstringRecipient of the transferred tokens.
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.transferStake


transferStake(uint256,uint256,address,address,uint256,uint256,address)

transferStake(uint256,uint256,address,address,uint256,uint256,address)(_permissionDomainId, _childSkillIndex, _obligator, _user, _domainId, _amount, _recipient, overrides?): Promise<ContractTransaction>

Transfer some amount of obligated tokens. Can be called by the arbitration role.

Parameters

NameTypeDescription
_permissionDomainIdBigNumberishThe domainId in which I have the permission to take this action.
_childSkillIndexBigNumberishThe child index in _permissionDomainId where we can find _domainId.
_obligatorstringAddress of the account who set the obligation.
_userstringAddress of the account we are transferring.
_domainIdBigNumberishDomain in which we are transferring the tokens.
_amountBigNumberishAmount of internal token we are transferring.
_recipientstringRecipient of the transferred tokens.
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.transferStake(uint256,uint256,address,address,uint256,uint256,address)


transferStakeWithProofs

transferStakeWithProofs(_obligator, _user, _domainId, _amount, _recipient, overrides?): Promise<ContractTransaction>

Same as transferStake, but let colonyJS figure out the permission proofs for you. Always prefer this method, except when you have good reason not to.

Parameters

NameTypeDescription
_obligatorstringAddress of the account who set the obligation.
_userstringAddress of the account we are transferring.
_domainIdBigNumberishDomain in which we are transferring the tokens.
_amountBigNumberishAmount of internal token we are transferring.
_recipientstringRecipient of the transferred tokens.
overrides?TxOverrides-

Returns

Promise<ContractTransaction>

Inherited from

ColonyAugmentsV5.transferStakeWithProofs


uninstallExtension

uninstallExtension(extensionId, overrides?): Promise<ContractTransaction>

This is a permanent action -- re-installing the extension will deploy a new contractIt is recommended to deprecate an extension before uninstalling to allow active objects to be resolved Uninstall an extension from a colony. Secured function to authorised members.

Parameters

NameTypeDescription
extensionIdBytesLikekeccak256 hash of the extension name, used as an indentifier
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.uninstallExtension


uninstallExtension(bytes32)

uninstallExtension(bytes32)(extensionId, overrides?): Promise<ContractTransaction>

This is a permanent action -- re-installing the extension will deploy a new contractIt is recommended to deprecate an extension before uninstalling to allow active objects to be resolved Uninstall an extension from a colony. Secured function to authorised members.

Parameters

NameTypeDescription
extensionIdBytesLikekeccak256 hash of the extension name, used as an indentifier
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.uninstallExtension(bytes32)


unlockToken

unlockToken(overrides?): Promise<ContractTransaction>

unlock the native colony token, if possible

Parameters

NameType
overrides?Overrides & { from?: string }

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.unlockToken


unlockToken()

unlockToken()(overrides?): Promise<ContractTransaction>

unlock the native colony token, if possible

Parameters

NameType
overrides?Overrides & { from?: string }

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.unlockToken()


unlockTokenForUser

unlockTokenForUser(user, lockId, overrides?): Promise<ContractTransaction>

Unlock the colony's token for a user. Can only be called by a network-managed extension.

Parameters

NameTypeDescription
userstringThe user to unlock
lockIdBigNumberishThe specific lock to unlock
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.unlockTokenForUser


unlockTokenForUser(address,uint256)

unlockTokenForUser(address,uint256)(user, lockId, overrides?): Promise<ContractTransaction>

Unlock the colony's token for a user. Can only be called by a network-managed extension.

Parameters

NameTypeDescription
userstringThe user to unlock
lockIdBigNumberishThe specific lock to unlock
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.unlockTokenForUser(address,uint256)


updateApprovalAmount

updateApprovalAmount(token, spender, overrides?): Promise<ContractTransaction>

Update the internal bookkeeping around external ERC20 approvals

Parameters

NameTypeDescription
tokenstringThe address of the token which was approved
spenderstringThe account we have approved
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.updateApprovalAmount


updateApprovalAmount(address,address)

updateApprovalAmount(address,address)(token, spender, overrides?): Promise<ContractTransaction>

Update the internal bookkeeping around external ERC20 approvals

Parameters

NameTypeDescription
tokenstringThe address of the token which was approved
spenderstringThe account we have approved
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.updateApprovalAmount(address,address)


updateColonyOrbitDB

updateColonyOrbitDB(orbitdb, overrides?): Promise<ContractTransaction>

Update a colony's orbitdb address. Can only be called by a colony with a registered subdomain

Parameters

NameTypeDescription
orbitdbstringThe path of the orbitDB database to be associated with the colony
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.updateColonyOrbitDB


updateColonyOrbitDB(string)

updateColonyOrbitDB(string)(orbitdb, overrides?): Promise<ContractTransaction>

Update a colony's orbitdb address. Can only be called by a colony with a registered subdomain

Parameters

NameTypeDescription
orbitdbstringThe path of the orbitDB database to be associated with the colony
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.updateColonyOrbitDB(string)


upgrade

upgrade(_newVersion, overrides?): Promise<ContractTransaction>

Downgrades are not allowed, i.e. _newVersion should be higher than the currect colony version. Upgrades a colony to a new Colony contract version _newVersion.

Parameters

NameTypeDescription
_newVersionBigNumberishThe target version for the upgrade
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.upgrade


upgrade(uint256)

upgrade(uint256)(_newVersion, overrides?): Promise<ContractTransaction>

Downgrades are not allowed, i.e. _newVersion should be higher than the currect colony version. Upgrades a colony to a new Colony contract version _newVersion.

Parameters

NameTypeDescription
_newVersionBigNumberishThe target version for the upgrade
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.upgrade(uint256)


upgradeExtension

upgradeExtension(extensionId, newVersion, overrides?): Promise<ContractTransaction>

Upgrade an extension in a colony. Secured function to authorised members.

Parameters

NameTypeDescription
extensionIdBytesLikekeccak256 hash of the extension name, used as an indentifier
newVersionBigNumberishThe version to upgrade to (must be one larger than the current version)
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.upgradeExtension


upgradeExtension(bytes32,uint256)

upgradeExtension(bytes32,uint256)(extensionId, newVersion, overrides?): Promise<ContractTransaction>

Upgrade an extension in a colony. Secured function to authorised members.

Parameters

NameTypeDescription
extensionIdBytesLikekeccak256 hash of the extension name, used as an indentifier
newVersionBigNumberishThe version to upgrade to (must be one larger than the current version)
overrides?Overrides & { from?: string }-

Returns

Promise<ContractTransaction>

Inherited from

AugmentedIColony.upgradeExtension(bytes32,uint256)


upgradeExtensionChecked

upgradeExtensionChecked(extension, newVersion?, overrides?): Promise<ContractTransaction>

Similar to upgradeExtension, but first check whether the desired extension can be upgraded to the desired version in this Colony Always prefer this method, except when you have good reason not to.

Parameters

NameTypeDescription
extensionExtensionA Extension name
newVersion?numberThe desired version number of the extension you wish to upgrade
overrides?TxOverrides-

Returns

Promise<ContractTransaction>

Inherited from

ColonyAugmentsV5.upgradeExtensionChecked


userCanSetRoles

userCanSetRoles(_user, _domainId, _childSkillIndex, _childDomainId, overrides?): Promise<boolean>

Check whether a given user can modify roles in the target domain _childDomainId. Mostly a convenience function to provide a uniform interface for extension contracts validating permissions

Parameters

NameTypeDescription
_userstringThe user whose permissions we want to check
_domainIdBigNumberishDomain in which the caller has the role (currently Root or Architecture)
_childSkillIndexBigNumberishThe index that the _childDomainId is relative to _domainId
_childDomainIdBigNumberishThe domain where we want to edit roles
overrides?CallOverrides-

Returns

Promise<boolean>

Inherited from

AugmentedIColony.userCanSetRoles


userCanSetRoles(address,uint256,uint256,uint256)

userCanSetRoles(address,uint256,uint256,uint256)(_user, _domainId, _childSkillIndex, _childDomainId, overrides?): Promise<boolean>

Check whether a given user can modify roles in the target domain _childDomainId. Mostly a convenience function to provide a uniform interface for extension contracts validating permissions

Parameters

NameTypeDescription
_userstringThe user whose permissions we want to check
_domainIdBigNumberishDomain in which the caller has the role (currently Root or Architecture)
_childSkillIndexBigNumberishThe index that the _childDomainId is relative to _domainId
_childDomainIdBigNumberishThe domain where we want to edit roles
overrides?CallOverrides-

Returns

Promise<boolean>

Inherited from

AugmentedIColony.userCanSetRoles(address,uint256,uint256,uint256)


verifyReputationProof

verifyReputationProof(key, value, branchMask, siblings, overrides?): Promise<boolean>

For more detail about branchMask and siblings, examine the PatriciaTree implementation. While external, likely only to be used by the Colony contracts, as it checks that the user is proving their own reputation in the current colony. The verifyProof function can be used to verify any proof, though this function is not currently exposed on the Colony's EtherRouter. Helper function that can be used by a client to verify the correctness of a patricia proof they have been supplied with.

Parameters

NameTypeDescription
keyBytesLikeThe key of the element the proof is for.
valueBytesLikeThe value of the element that the proof is for.
branchMaskBigNumberishThe branchmask of the proof
siblingsBytesLike[]The siblings of the proof
overrides?CallOverrides-

Returns

Promise<boolean>

Inherited from

AugmentedIColony.verifyReputationProof


verifyReputationProof(bytes,bytes,uint256,bytes32[])

verifyReputationProof(bytes,bytes,uint256,bytes32[])(key, value, branchMask, siblings, overrides?): Promise<boolean>

For more detail about branchMask and siblings, examine the PatriciaTree implementation. While external, likely only to be used by the Colony contracts, as it checks that the user is proving their own reputation in the current colony. The verifyProof function can be used to verify any proof, though this function is not currently exposed on the Colony's EtherRouter. Helper function that can be used by a client to verify the correctness of a patricia proof they have been supplied with.

Parameters

NameTypeDescription
keyBytesLikeThe key of the element the proof is for.
valueBytesLikeThe value of the element that the proof is for.
branchMaskBigNumberishThe branchmask of the proof
siblingsBytesLike[]The siblings of the proof
overrides?CallOverrides-

Returns

Promise<boolean>

Inherited from

AugmentedIColony.verifyReputationProof(bytes,bytes,uint256,bytes32[])


version

version(overrides?): Promise<BigNumber>

Get the Colony contract version. Starts from 1 and is incremented with every deployed contract change.

Parameters

NameType
overrides?CallOverrides

Returns

Promise<BigNumber>

Inherited from

AugmentedIColony.version


version()

version()(overrides?): Promise<BigNumber>

Get the Colony contract version. Starts from 1 and is incremented with every deployed contract change.

Parameters

NameType
overrides?CallOverrides

Returns

Promise<BigNumber>

Inherited from

AugmentedIColony.version()