Skip to main content

Force Transfer

General Provisions and Scope​

The Force Transfer feature is an advanced administrative capability within the DEUSS platform's Life Cycle Management. It empowers authorized DEUSS Backoffice personnel to unilaterally transfer bond tokens from one wallet to another on-chain, bypassing standard user consent mechanics.

This feature is strictly reserved for exceptional circumstances, including but not limited to:

  • Legal or Regulatory Orders: Complying with court orders, asset seizures, or sanctions (e.g., redirecting assets to a government-designated wallet).
  • Key Recovery / Wallet Loss: Aiding an investor who has verifiably lost access to their wallet by transferring their holdings to a newly generated, secure wallet.
  • Compliance Remediation: Rectifying fraudulent transactions or severe compliance violations detected post-settlement.

IMPORTANT: Protected Addresses To ensure the security of critical infrastructure (such as the Escrow or Marketplace contracts), certain addresses can be marked as protectedAddress on-chain. Force transfers cannot pull funds from protected addresses.

Business Flow​

  1. Administrative Initiation:

    • A DEUSS Backoffice administrator (holding the appropriate off-chain permissions) initiates a force transfer request via the administrative interface.
    • The request specifies the from address, to address, tokenId, and amount.

  2. On-Chain Execution:

    • The administrative backend relays the transaction to the DEUSSToken smart contract by calling forcedTransfer() or batchForcedTransfer().
    • The smart contract verifies that the caller has the FORCE_TRANSFER_ROLE.

  3. Validation and Unfreezing:

    • The contract verifies that the source address (from) is not flagged as a protected address.
    • If the tokens are currently frozen (e.g., due to an active offer or a temporary hold), the force transfer automatically unfreezes the required amount, prioritizing the administrative action over user-level locks.

  4. Completion:

    • The tokens are transferred, and the smart contract emits the standard transfer events.
    • The administrative backend listens for the events and updates the off-chain ledger to maintain sync.

Sequence Diagram​