Types
These types represent the on-chain account structures deserialized by the SDK. Import them with: import type { AgentIdentity, StakeAccount, ... } from '@vouch-protocol/sdk';
BN fields: Fields typed as BN use the bn.js library (re-exported by @coral-xyz/anchor). Convert to number with .toNumber() or to string with .toString(). For large values, use .toString() to avoid precision loss.
AgentTier
Observer
Basic
Standard
Premium
AgentStatus
Active
Suspended
Deactivated
ServiceCategory
Commerce
DataAnalysis
ContentCreation
CustomerService
Financial
Logistics
Development
Research
Other
Interfaces
AgentIdentity
On-chain agent account.
| Field | Type |
|---|---|
| owner | PublicKey |
| tier | AgentTier |
| capabilities | BN |
Capabilities bitmask: BUY=1, SELL=2, STAKE=4, REPORT=8, RELAY=16, ORACLE=32. Use bitwise AND to check: agent.capabilities.toNumber() & 1 checks BUY.
| Field | Type |
|---|---|
| name | string |
| serviceCategory | ServiceCategory |
| version | string |
| agentCardUrl | string |
| agentCardHash | number[] |
| status | AgentStatus |
| reputationScore | number |
| reputationUpdatedAt | BN |
| reputationChangeToday | number |
| reputationDayStart | BN |
| tierEffectiveAt | BN |
| createdAt | BN |
| updatedAt | BN |
| bump | number |
StakeAccount
USDC stake account.
| Field | Type |
|---|---|
| owner | PublicKey |
| agentPda | PublicKey |
| depositedAmount | BN |
| lockedAmount | BN |
| bump | number |
WithdrawalRequest
Pending withdrawal.
| Field | Type |
|---|---|
| stakeAccount | PublicKey |
| amount | BN |
| requestedAt | BN |
| bump | number |
DeactivationRecord
Record for deactivated agents.
| Field | Type |
|---|---|
| owner | PublicKey |
| deactivatedAt | BN |
| finalReputationScore | number |
| bump | number |
ReputationReporter
Whitelisted reporter program.
| Field | Type |
|---|---|
| reporterAuthority | PublicKey |
| label | string |
| weight | number |
| totalReportsSubmitted | number |
| active | boolean |
| bump | number |