Hedera Mirror Node多账户过滤配置求助：仅追踪指定账户活动

核心配置步骤 #

1. 定位配置文件
   找到镜像节点部署目录下的application.yml配置文件；若为Docker部署，可通过挂载配置文件或设置环境变量完成配置。

2. 添加账户过滤规则
   在hedera.mirror.importer节点下新增账户白名单配置，明确需要同步的完整账户ID：

   hedera:
     mirror:
       importer:
         account:
           allowlist: "0.0.accountA,0.0.accountB,0.0.accountC"
         transaction:
           filter:
             enabled: true
             allowlist:
               entities: "0.0.accountA,0.0.accountB,0.0.accountC"
   

   • account.allowlist：限制仅同步指定账户的状态变更（如创建、余额变动等）
   • transaction.filter.enabled：启用交易过滤开关
   • transaction.filter.allowlist.entities：指定仅同步涉及这些账户的所有交易（转账、合约交互等全量活动）

3. Docker部署的环境变量替代方案
   若使用Docker Compose部署，可直接在.env文件中设置对应环境变量：

   HEDERA_MIRROR_IMPORTER_ACCOUNT_ALLOWLIST=0.0.accountA,0.0.accountB,0.0.accountC
   HEDERA_MIRROR_IMPORTER_TRANSACTION_FILTER_ENABLED=true
   HEDERA_MIRROR_IMPORTER_TRANSACTION_FILTER_ALLOWLIST_ENTITIES=0.0.accountA,0.0.accountB,0.0.accountC
   

关键注意事项 #

• 账户ID必须使用shard.realm.account的完整格式（例如主网账户0.0.12345），不能仅填写账户编号
• 配置修改后需重启镜像节点服务才能生效
• 若需同步指定账户关联的合约活动，需将对应合约ID也加入白名单（如有涉及）
• 确保镜像节点版本在v0.60.0及以上，该版本完善了账户过滤的功能逻辑

内容的提问来源于stack exchange，提问作者EmmBee