Skip to main content

Token Ownership Workers

Two workers for managing NFT/token ownership: one for refreshing tokens and one for external ownership updates.

Installation​

import '@unchainedshop/plugins/worker/update-token-ownership';

Workers Included​

This file registers two workers:

1. Refresh Tokens Worker​

Automatically finds all tokens and accounts, then triggers ownership updates.

PropertyValue
Keyshop.unchained.worker-plugin.refresh-tokens
TypeREFRESH_TOKENS
Auto-ScheduleEvery minute

2. Update Token Ownership Worker (External)​

External worker placeholder for the actual ownership verification process.

PropertyValue
Keyshop.unchained.worker-plugin.update-token-ownership
TypeUPDATE_TOKEN_OWNERSHIP
Externaltrue

How It Works​

Refresh Tokens Flow​

  1. Auto-scheduled every minute
  2. Collects tokens: Finds all tokens with wallet addresses
  3. Collects accounts: Finds all users with verified Web3 addresses
  4. Creates work: Triggers UPDATE_TOKEN_OWNERSHIP with the token and account data
  5. External processing: An external system processes the ownership verification

External Update Flow​

  1. External system receives UPDATE_TOKEN_OWNERSHIP work
  2. Verifies token ownership on the blockchain
  3. Marks work as complete via GraphQL

Manual Trigger​

Refresh All Tokens​

// Trigger via API
await unchainedAPI.modules.worker.addWork({
  type: 'REFRESH_TOKENS',
});

Update Specific Tokens (External)​

// Trigger via API
await unchainedAPI.modules.worker.addWork({
  type: 'UPDATE_TOKEN_OWNERSHIP',
  input: {
    filter: {
      tokens: [{ _id: 'token-1' }, { _id: 'token-2' }],
      accounts: ['0xAddress1', '0xAddress2'],
    },
  },
});

Result​

Refresh Tokens​

{
  "forked": "update-token-ownership-work-id"
}

Input for UPDATE_TOKEN_OWNERSHIP​

ParameterTypeDescription
filter.tokensArrayToken objects to check ownership for
filter.accountsArrayWallet addresses to verify

Adapter Details​

REFRESH_TOKENS​

PropertyValue
Keyshop.unchained.worker-plugin.refresh-tokens
TypeREFRESH_TOKENS
Auto-ScheduleEvery minute
Retries0

UPDATE_TOKEN_OWNERSHIP​

PropertyValue
Keyshop.unchained.worker-plugin.update-token-ownership
TypeUPDATE_TOKEN_OWNERSHIP
Externaltrue

Source​

worker/update-token-ownership.ts