Core: Implement Automated On-Chain Data Backup with IPFS Archival

[Smartdevs17]

Context

On-chain transaction data is permanent but not easily retrievable. RPC endpoints have rate limits and history constraints, making data recovery difficult.

Current Limitation/Problem

AgenticPay relies on RPC nodes for historical data access. Data could be lost if RPC providers prune history or if the backend database is corrupted. There is no decentralized backup.

Expected Outcome

An automated archival system that periodically backs up on-chain transaction data, event logs, and contract state to IPFS, with content-addressed retrieval and restore capability.

Acceptance Criteria

• Archive transaction data from all supported chains to IPFS
• Data format: normalized JSON with proof-of-inclusion (tx hash, block number)
• Daily archival batches with IPFS CID recorded on-chain or in database
• Data integrity verification: compute hash before and after archival
• Restore workflow: download from IPFS and re-index into database
• Dashboard showing last archive timestamp, size, and CID
• Retention policy: full archives for 7 years
• Compression before archival (<100MB per daily archive)

Technical Scope

• backend/src/services/archival/ - archival service
• IPFS client (Pinata, web3.storage, or local IPFS node)
• backend/src/services/archival/data-collector.ts - data gathering
• backend/src/services/archival/ipfs-uploader.ts - IPFS upload
• BullMQ cron for daily archival
• Prisma: DataArchive, ArchivalBatch models
• Edge cases: IPFS node unavailability, large datasets, partial chain data, restore conflicts

[pauljuliet9900-netizen]

@pauljuliet9900-netizen has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

Hello maintainer i would like to work on this issue

ℹ️ Repo Maintainers: To accept this application, review their application or assign @pauljuliet9900-netizen to this issue.

[Yasir-TechGuy]

@Yasir-TechGuy has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

Please assign this issue to me,
I won’t disappoint u

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Yasir-TechGuy to this issue.

[Bigmehelen]

@Bigmehelen has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

I would like to work on this project, please assign me to this project

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Bigmehelen to this issue.

[code-0-stella]

@code-0-stella has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

Hi, I'd like to work on this issue.

I've gone through the requirements, understand the problem, and have the skills needed to implement a solution.

Could you please assign it to me?

ℹ️ Repo Maintainers: To accept this application, review their application or assign @code-0-stella to this issue.

[thefifthdev]

@thefifthdev has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

I have full stack experience, I can tackle this

ℹ️ Repo Maintainers: To accept this application, review their application or assign @thefifthdev to this issue.

[olufunsoolutayo]

@olufunsoolutayo has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

Hello maintainer. I would love to resolve this issue in no time. Pls assign to me. Thank you

ℹ️ Repo Maintainers: To accept this application, review their application or assign @olufunsoolutayo to this issue.

[devsimze]

@devsimze has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

Hi I'd like to work on this issue

ℹ️ Repo Maintainers: To accept this application, review their application or assign @devsimze to this issue.

[drips-wave]

Congratulations, @devsimze! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on June 30, 2026.

🧑‍💻 @devsimze: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊