[CT-12] Add bulk document registration to document registry contract

[mftee]

Problem

A single shipment typically has multiple associated documents (Bill of Lading, Proof of Delivery, customs declaration, insurance certificate). Registering each document separately on-chain requires a separate transaction per document, multiplying the cost and latency of post-delivery document submission.

Proposed Solution

Create a bulk document registration function in a new contract inside contracts/package/document-bulk/ that registers multiple documents in a single atomic transaction.

Note: All work must be done inside the contracts/package/ directory. Do not modify any existing contract files outside this folder.

Acceptance Criteria

• register_documents_batch(docs: Vec<DocumentEntry>) where DocumentEntry = { hash: BytesN<32>, doc_type: Symbol, ipfs_cid: String, expires_at: Option<u64> }
• Maximum 10 documents per batch; exceeding returns BatchLimitExceeded
• Each hash is validated to be unique (not previously registered); a duplicate returns HashAlreadyRegistered
• The batch is atomic: if any document fails validation, no documents from the batch are registered
• Returns Vec<BytesN<32>> — the list of document IDs created
• Unit tests cover: valid batch of 5, duplicate hash causes full rollback, batch exceeding 10 documents

[Clement-coder]

@Clement-coder has applied to work on this issue as part of the Stellar Wave Program's 5th wave.

Hi, I’m a Full-Stack Software & Blockchain Engineer with experience building Soroban smart contracts, atomic batch operations, and on-chain document management systems.

I’d like to take on this issue. I can implement the bulk document registration contract with atomic validation, duplicate-hash protection, batch size enforcement, and comprehensive unit tests while keeping all work scoped correctly within contracts/package/.

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

[A6dulmalik]

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

I’d like to implement the bulk document registration contract with atomic batch processing, duplicate hash validation, and strict batch size enforcement.
I can deliver the full Soroban contract and unit tests covering successful batches, rollback behavior on duplicates, and batch limit validation entirely within contracts/package/.

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

[drips-wave]

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

🧑‍💻 @A6dulmalik: 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 🌊