Skip to main content

Events Reference

Complete reference for all events emitted by BCO Protocol contracts. Use these events to build indexers, dashboards, and analytics.

BCOToken Events​

Transfer​

event Transfer(address indexed from, address indexed to, uint256 value);

Standard ERC-20 transfer. from = address(0) on mint, to = address(0) on burn.

Emitted by: transfer(), transferFrom(), mint(), burnFrom().

Approval​

event Approval(address indexed owner, address indexed spender, uint256 value);

Emitted by: approve(), permit().

TokenRecovered​

event TokenRecovered(address indexed token, address indexed to, uint256 amount);

Emitted by: recoverERC20(). Audit trail for admin recovery operations.

NativeRecovered​

event NativeRecovered(address indexed to, uint256 amount);

Emitted by: recoverNative(). Tracks recovery of force-deposited TRX/ETH.

ContractURIUpdated​

event ContractURIUpdated();

No parameters. Emitted when the ERC-7572 contract metadata URI is changed.

Emitted by: setContractURI(). Fetch the new URI via contractURI() after this event.

IssuerInfoUpdated​

event IssuerInfoUpdated(string name, string registration, string country);

Emitted by: setIssuerInfo(). Tracks changes to on-chain issuer identity.

Paused / Unpaused​

event Paused(address account);
event Unpaused(address account);

Emitted by: pause(), unpause(). Emergency monitoring — alert systems should trigger on Paused.

DeedRegistry Events​

DeedRegistered​

event DeedRegistered(
    bytes32 indexed id,
    uint256 areaM2,
    string geolocation,
    string documentHash,
    address indexed registeredBy,
    uint256 tokensMinted
);

Emitted by: registerDeed(). Core event for tracking forest deed registrations. The documentHash can be used to fetch and verify documents on IPFS.

DeedDeactivated​

event DeedDeactivated(
    bytes32 indexed id,
    uint256 areaM2,
    string reason,
    uint256 tokensBurned
);

Emitted by: deactivateDeed(). Tracks supply contractions and deactivation reasons.

DocumentsUpdated​

event DocumentsUpdated(
    bytes32 indexed id,
    string oldDocumentHash,
    string newDocumentHash,
    string reason
);

Emitted by: updateDocuments(). Audit trail for document revisions.

RateLimitsUpdated​

event RateLimitsUpdated(uint256 maxDailyRegistrations, uint256 maxAreaPerDeed);

Emitted by: setRateLimits().

TreasuryUpdated​

event TreasuryUpdated(address indexed oldTreasury, address indexed newTreasury);

Emitted by: setTreasury(). Monitors where new mints are directed.

TimelockChanged​

event TimelockChanged(address indexed oldTimelock, address indexed newTimelock);

Emitted by: setTimelock(). Critical governance event.

DirectUpgradeSupplyLimitChanged​

event DirectUpgradeSupplyLimitChanged(uint256 oldLimit, uint256 newLimit);

Emitted by: setDirectUpgradeSupplyLimit(). Progressive timelock threshold change.

BCOStaking Events​

Deposited​

event Deposited(address indexed user, uint256 amount, uint48 lockUntil);

Emitted by: deposit(). Track staking deposits and lock expiration times.

Withdrawn​

event Withdrawn(address indexed user, uint256 amount);

Emitted by: withdraw(). Also emits RewardClaimed if the user has pending rewards.

RewardClaimed​

event RewardClaimed(address indexed user, uint256 reward);

Emitted by: claimRewards(), and during withdraw() if rewards are pending.

EmergencyWithdrawn​

event EmergencyWithdrawn(address indexed user, uint256 amount);

Emitted by: emergencyWithdraw(). A spike in these events may indicate a protocol concern. Emergency withdrawals forfeit all pending rewards.

RewardAdded​

event RewardAdded(uint256 amount, uint256 rewardRate, uint256 periodFinish);

Emitted by: notifyRewardAmount(). Use rewardRate and totalStaked to calculate APY.

RewardDurationUpdated​

event RewardDurationUpdated(uint256 newDuration);

Emitted by: setRewardDuration().

LockParametersUpdated​

event LockParametersUpdated(uint48 minLock, uint48 maxLock);

Emitted by: setLockParameters().

Shared Events​

The following events are emitted by all three contracts with identical signatures:

  • TokenRecovered(address indexed token, address indexed to, uint256 amount)
  • NativeRecovered(address indexed to, uint256 amount)
  • ContractURIUpdated()
  • IssuerInfoUpdated(string name, string registration, string country)
  • Paused(address account)
  • Unpaused(address account)

Indexing Guide​

Common Queries​

QueryEvents to Index
Total supply over timeTransfer where from = address(0) (mints) and to = address(0) (burns)
Active deedsDeedRegistered minus DeedDeactivated (match by id)
Total forest areaSum areaM2 from DeedRegistered minus sum from DeedDeactivated
TVL in stakingRunning sum of Deposited.amount - Withdrawn.amount - EmergencyWithdrawn.amount
Staking APYRewardAdded.rewardRate * 31536000 / totalStaked * 100
Governance changesTreasuryUpdated, TimelockChanged, DirectUpgradeSupplyLimitChanged, RateLimitsUpdated

Contract Addresses for Event Filtering​

Event CategoryContract
Token transfers and approvalsBCOToken (TWyRGyikCy1TGkz9etJr8a3NDQcMx3F28p)
Deed lifecycleDeedRegistry (TPw2dKZcVwqCKDNCQbEwRory1xKqj6zSj1)
Staking activityBCOStaking (TLXMq6XnwCyS9z3B8tbuNA82JJfjUnDNFe)

TronGrid Event API​

const events = await tronWeb.getEventResult(
  'TPw2dKZcVwqCKDNCQbEwRory1xKqj6zSj1',
  {
    eventName: 'DeedRegistered',
    sinceTimestamp: Date.now() - 86400000, // Last 24 hours
    sort: 'block_timestamp',
    size: 200
  }
);

For high-volume indexing, use TronGrid's event subscription API or run your own full node with event plugins.