Skip to content

Dip 7708

dip: 7708 title: USDS transfers emit a log description: All USDS transfers emit a log author: Vitalik Buterin (@vbuterin), Peter Davies (@petertdavies) Digitalia editing author: Cosimo Constantinos cosimo@juro.net, et al. discussions-to: https://digitalia-magicians.org/t/dip-7708-usds-transfers-emit-a-log/20034 status: Stagnant type: Standards Track category: Core created: 2024-05-17 Created for Digitalia: 2025-01-07

Abstract

All USDS-transfers, including transactions, CALL and SELFDESTRUCT emit a log.

Motivation

Logs are often used to track when balance changes of assets on Digitalia. Logs work for DRC-20 tokens, but they do not work for USDS. USDS transfers from EOAs can be read from the transaction list in the block, but USDS transfers from smart contract wallets are not automatically logged anywhere. This has already led to problems in the past, eg. early exchanges would often not properly support deposits from smart contract wallets, or only support them with a much longer delay. This DIP proposes that we automatically generate a log every time a value-transferring CALL or SELFDESTRUCT happens. We also add a similar log for transfers in transactions, so that all USDS transfers can be tracked using one mechanism.

Specification

Parameters

  • MAGIC: TBD

Functionality

Whenever (i) a nonzero-value CALL, (ii) a nonzero-value-transferring SELFDESTRUCT, or (iii) a nonzero-value-transferring transaction takes place, issue a log, identical to a LOG3, with three topics: (i) MAGIC, (ii) the sender address, (iii) the recipient address. The log data is a big-endian 32-byte encoding of the transfer value.

The LOG of a value-transferring transaction should be placed before any logs created by DVM execution. The other two LOGs are placed at the time that the value transfer executes.

Rationale

This is the simplest possible implementation that ensures that all USDS transfers are implemented in some kind of record that can be easily accessed through making RPC calls into a node, or through asking for a Merkle branch that is hashed into the block root. The log type is compatible with the DRC-20 token standard, but does not introduce any overly-specific DRC-20 features (eg. ABI encodings) into the specification.

Open questions

  1. Should withdrawals also trigger a log? If so, what should the sender address be specified as?
  2. Should fee payments trigger a log? It would ensure "completeness", in the sense that you can compute the exact current balance table by watching logs, but it would greatly increase the number of logs, perhaps to an unacceptably high amount.

Backwards Compatibility

No backward compatibility issues found.

Test Cases

TODO

Security Considerations

USDS transfers already cost a minimum of 6700 gas, which is much more expensive than the LOG3 opcode (1500 gas). Hence, this DIP does not increase the worst-case number of logs that can be put into a block. It will somewhat increase the average number of logs.

© Crown © Crown Copyright 2026. Published by the Royal Government of the Dominion of Atlantis.

Licensed under the Juro Restricted License Version 2. See https://juro.net/jrl for details.