Verified registry actor

Verified registry actor is responsible for managing verified clients.

The ActorCode for the verified registry built-in actor is hex"0006" which will be used to call the exported methods in the verified registry built-in actor. You need to specify the method number for the method you want to invoke. Please referer to each method for its method number.

AddVerifiedClient #

func AddVerifiedClient(params AddVerifiedClientParams) EmptyValue {}

To add a verified Client address to Filecoin Plus program.

uint constant AddVerifierClientMethodNum = 3916220144.

Params:

• struct AddVerifierClientParams
  • bytes Address - the verified client address
  • int256 Allowance - approved DataCap for this verified client

Results:

• struct EmptyValue.

RemoveExpiredAllocations #

func RemoveExpiredAllocations(params RemoveExpiredAllocationsParams) RemoveExpiredAllocationsReturn {}

Remove the expired DataCap allocations and reclaim those DataCap tokens back to the client. If the allocation amount is not specified, all expired DataCap allocations will be removed.

uint RemoveExpiredAllocationsMethodNum = 2873373899.

Params:

• struct RemoveExpiredAllocationsParams
  • uint64 Client - the client address to remove the expired tokens from.
  • uint64[] AllocationIDs - List of allocation IDs to attempt to remove. If empty, this method will remove all eligible expired tokens.

Results:

• struct RemoveExpiredAllocationsReturn
  • unit64[] Considered - Allocation IDs are either specified by the caller or discovered to be expired.
  • BatachReturn Results - results for each processed allocation.
  • int256 DataCapRecoverd - The amount of DataCap token reclaimed for the client.

GetClaims #

func GetClaims(params GetClaimsParams) GetClaimsReturn {}

Return a list of claims corresponding to the requested claim ID for a specific provider.

uint GetClaimsMethodNum = 2199871187.

Params:

• structGetClaimsParams
  • uint64 Provider - the provider address.
  • unit64[] ClaimIDs - A list of Claim IDs for a specific provider.

Results:

• struct GetClaimsReturn

  • struct BatchReturn

    • uint32 SuccessCount - total successes in the batch.
    • struct FailCode[] {uint32 idx, uint32 code} - list of failure code and index for all failures in batch.

  • struct Claim[] Claims - list of Claims returned.

    • uint64 Provider - The provider that is storing the data.
    • uint64 Client - The client that originally allocated the DataCap.
    • bytes Data - Identifier for the data committed.
    • uint64 Size - The size of the data.
    • int64 TermMin - The minimum period after the term starts, during which the provider must commit to storing data.
    • int64 TermMax - The maximum period after the term starts for which the provider can earn Quality Adjusted power for the data.
    • int64 TermStart - the epoch at which the piece was committed.
    • unit64 Sector - ID of the provider’s sector in which the data is committed.

ExtendClaimTerms #

func ExtendClaimTerms(params ExtendClaimTermsParams) ExtendClaimTermsReturn {}

Extends the maximum term of some claims up to the largest value they could have been originally allocated. This method can only be called by the claims’ client.

uint ExtendClaimTermsMethodNum = 1752273514.

Params:

• struct ExtendClaimTermsParams
  • struct ClaimTerm[] Terms
    • uint64 Provider - The provider address which stores the data.
    • uint64 CliamID - Claim ID.
    • int64 TermMax - The max chain epoch to extend.

Results:

• struct ExtendClaimTermsReturn
  • struct BatchReturn
    • uint32 SuccessCount - total successes in the batch.
    • struct FailCodes[] {uint32 idx, uint32 code} - list of failure code and index for all failures in batch.

RemoveExpiredClaims #

func RemoveExpiredClaims(params: RemoveExpiredClaimsParams) RemoveExpiredClaimsReturn {}

To remove a claim with its maximum term has elapsed.

uint RemoveExpiredClaimsMethodNum = 2873373899.

Params:

• struct RemoveExpiredClaimsParams
  • uint64 Provider - the provider address.
  • unit64[] ClaimIDs - A list of Claim IDs with an expired term. If no claims are specified, all eligible claims will be removed.

Results:

• struct RemoveExpiredClaimsReturn
  • uint64[] Considered - a list of IDs of the claims that were either specified by the caller or discovered to be expired.
  • struct BatchReturn
    • uint32 SuccessCount - total successes in the batch
    • struct FailCodes[] {uint32 idx, uint32 code} - list of failure code and index for all failures in batch.