4. Compliance & Cryptographic Evidence

The following methods are available via the AgriBackup SDK for this integration stage.

Generate Bulk Archive Report

Asynchronously compiles XML payloads, Hedera state proofs, and legal document hashes into a single cryptographic ZIP artifact. Triggers a 'report.ready' webhook upon completion.

Node.js

import { AgriBackupClient } from 'agribackup';

const client = new AgriBackupClient('sk_live_...');
const archiveReportRequest = {
  "startDate": "2026-01-01",
  "endDate": "2026-03-31"
};
const response = await client.api.triggerArchiveReport(archiveReportRequest);
console.log(response.data);

Python

from agribackup import AgriBackupClient
from agribackup.models import ArchiveReportRequest

client = AgriBackupClient('sk_live_...')
archive_report_request = ArchiveReportRequest(start_date="2026-01-01", end_date="2026-03-31")
response = client.api.trigger_archive_report(archive_report_request=archive_report_request)
print(response)

Java

import com.agribackup.AgriBackupClient;
import com.agribackup.model.ArchiveReportRequest;
import java.util.Arrays;

AgriBackupClient client = new AgriBackupClient("sk_live_...");
var archiveReportRequest = new ArchiveReportRequest()
    .start_date("2026-01-01")
    .end_date("2026-03-31");
var response = client.api.triggerArchiveReport(archiveReportRequest);
System.out.println(response);

C#

using AgriBackup;
using AgriBackup.Model;
using System.Collections.Generic;

var client = new AgriBackupClient("sk_live_...");
var archiveReportRequest = new ArchiveReportRequest {
    StartDate = "2026-01-01",
    EndDate = "2026-03-31"
};
var response = await client.Api.TriggerArchiveReportAsync(archiveReportRequest);
Console.WriteLine(response);

Upload Legal Land Tenure Document

Ingests physical PDF or binary documents required by TRACES NT, returns a secure cryptographic hash and internal reference URL for inclusion in the DDS payload.

Node.js

import { AgriBackupClient } from 'agribackup';

const client = new AgriBackupClient('sk_live_...');
const response = await client.declarations.uploadDocument('documentUrl', 'requestBody');
console.log(response.data);

Python

from agribackup import AgriBackupClient

client = AgriBackupClient('sk_live_...')
response = client.declarations.upload_document('documentUrl', 'requestBody')
print(response)

Java

import com.agribackup.AgriBackupClient;

AgriBackupClient client = new AgriBackupClient("sk_live_...");
var response = client.declarations.uploadDocument("documentUrl", "requestBody");
System.out.println(response);

C#

using AgriBackup;

var client = new AgriBackupClient("sk_live_...");
var response = await client.Declarations.UploadDocumentAsync("documentUrl", "requestBody");
Console.WriteLine(response);

List Generated Due Diligence Statements

Returns a cursor-paginated list of generated DDS payloads and their Hedera consensus states.

Node.js

import { AgriBackupClient } from 'agribackup';

const client = new AgriBackupClient('sk_live_...');
const response = await client.declarations.listDdsPayloads('starting_after', 'limit');
console.log(response.data);

Python

from agribackup import AgriBackupClient

client = AgriBackupClient('sk_live_...')
response = client.declarations.list_dds_payloads('starting_after', 'limit')
print(response)

Java

import com.agribackup.AgriBackupClient;

AgriBackupClient client = new AgriBackupClient("sk_live_...");
var response = client.declarations.listDdsPayloads("starting_after", "limit");
System.out.println(response);

C#

using AgriBackup;

var client = new AgriBackupClient("sk_live_...");
var response = await client.Declarations.ListDdsPayloadsAsync("starting_after", "limit");
Console.WriteLine(response);

Generate Due Diligence Statement (DDS)

Generates a TRACES NT compliant DDS. Autonomously anchors provided legal_document_hashes to the Hedera ledger for land tenure proof.

Node.js

import { AgriBackupClient } from 'agribackup';

const client = new AgriBackupClient('sk_live_...');
const ddsGenerationRequest = {
  "batchId": "uuid-1234",
  "legalDocumentHashes": [
    "string"
  ]
};
const response = await client.declarations.generateDds(ddsGenerationRequest);
console.log(response.data);

Python

from agribackup import AgriBackupClient
from agribackup.models import DdsGenerationRequest

client = AgriBackupClient('sk_live_...')
dds_generation_request = DdsGenerationRequest(batch_id="uuid-1234", legal_document_hashes=["string"])
response = client.declarations.generate_dds(dds_generation_request=dds_generation_request)
print(response)

Java

import com.agribackup.AgriBackupClient;
import com.agribackup.model.DdsGenerationRequest;
import java.util.Arrays;

AgriBackupClient client = new AgriBackupClient("sk_live_...");
var ddsGenerationRequest = new DdsGenerationRequest()
    .batch_id("uuid-1234")
    .legal_document_hashes(Arrays.asList("string"));
var response = client.declarations.generateDds(ddsGenerationRequest);
System.out.println(response);

C#

using AgriBackup;
using AgriBackup.Model;
using System.Collections.Generic;

var client = new AgriBackupClient("sk_live_...");
var ddsGenerationRequest = new DdsGenerationRequest {
    BatchId = "uuid-1234",
    LegalDocumentHashes = new List<string> { "string" }
};
var response = await client.Declarations.GenerateDdsAsync(ddsGenerationRequest);
Console.WriteLine(response);

Submit DDS to TRACES NT

Executes the SOAP API handshake with TRACES NT utilizing Vault-decrypted tokens, and returns the official EU reference number.

Node.js

import { AgriBackupClient } from 'agribackup';

const client = new AgriBackupClient('sk_live_...');
const response = await client.declarations.submitDds('referenceId');
console.log(response.data);

Python

from agribackup import AgriBackupClient

client = AgriBackupClient('sk_live_...')
response = client.declarations.submit_dds('referenceId')
print(response)

Java

import com.agribackup.AgriBackupClient;

AgriBackupClient client = new AgriBackupClient("sk_live_...");
var response = client.declarations.submitDds("referenceId");
System.out.println(response);

C#

using AgriBackup;

var client = new AgriBackupClient("sk_live_...");
var response = await client.Declarations.SubmitDdsAsync("referenceId");
Console.WriteLine(response);

Revoke a submitted DDS

Dispatches a revocation request to TRACES NT and anchors the revocation timestamp and receipt on Hedera.

Node.js

import { AgriBackupClient } from 'agribackup';

const client = new AgriBackupClient('sk_live_...');
const response = await client.declarations.revokeDds('referenceId');
console.log(response.data);

Python

from agribackup import AgriBackupClient

client = AgriBackupClient('sk_live_...')
response = client.declarations.revoke_dds('referenceId')
print(response)

Java

import com.agribackup.AgriBackupClient;

AgriBackupClient client = new AgriBackupClient("sk_live_...");
var response = client.declarations.revokeDds("referenceId");
System.out.println(response);

C#

using AgriBackup;

var client = new AgriBackupClient("sk_live_...");
var response = await client.Declarations.RevokeDdsAsync("referenceId");
Console.WriteLine(response);

Download Bulk Archive ZIP

Retrieves the compiled ZIP artifact. The download link is temporary and time-limited.

Node.js

import { AgriBackupClient } from 'agribackup';

const client = new AgriBackupClient('sk_live_...');
const response = await client.api.downloadArchiveReport('reportId');
console.log(response.data);

Python

from agribackup import AgriBackupClient

client = AgriBackupClient('sk_live_...')
response = client.api.download_archive_report('reportId')
print(response)

Java

import com.agribackup.AgriBackupClient;

AgriBackupClient client = new AgriBackupClient("sk_live_...");
var response = client.api.downloadArchiveReport("reportId");
System.out.println(response);

C#

using AgriBackup;

var client = new AgriBackupClient("sk_live_...");
var response = await client.Api.DownloadArchiveReportAsync("reportId");
Console.WriteLine(response);

Retrieve shipment cryptographic evidence

Traverses the supply chain graph to locate all EUDR batches mathematically linked to this shipment ID or Bill of Lading, returning their consolidated Hedera state proofs.

Node.js

import { AgriBackupClient } from 'agribackup';

const client = new AgriBackupClient('sk_live_...');
const response = await client.evidence.getShipmentLedgerEvidence('shipmentId');
console.log(response.data);

Python

from agribackup import AgriBackupClient

client = AgriBackupClient('sk_live_...')
response = client.evidence.get_shipment_ledger_evidence('shipmentId')
print(response)

Java

import com.agribackup.AgriBackupClient;

AgriBackupClient client = new AgriBackupClient("sk_live_...");
var response = client.evidence.getShipmentLedgerEvidence("shipmentId");
System.out.println(response);

C#

using AgriBackup;

var client = new AgriBackupClient("sk_live_...");
var response = await client.Evidence.GetShipmentLedgerEvidenceAsync("shipmentId");
Console.WriteLine(response);

Retrieve polygon cryptographic evidence

Returns raw Hedera transaction IDs, state proofs, and Merkle root hashes for a verified production polygon.

Node.js

import { AgriBackupClient } from 'agribackup';

const client = new AgriBackupClient('sk_live_...');
const response = await client.evidence.getPolygonLedgerEvidence('polygonId');
console.log(response.data);

Python

from agribackup import AgriBackupClient

client = AgriBackupClient('sk_live_...')
response = client.evidence.get_polygon_ledger_evidence('polygonId')
print(response)

Java

import com.agribackup.AgriBackupClient;

AgriBackupClient client = new AgriBackupClient("sk_live_...");
var response = client.evidence.getPolygonLedgerEvidence("polygonId");
System.out.println(response);

C#

using AgriBackup;

var client = new AgriBackupClient("sk_live_...");
var response = await client.Evidence.GetPolygonLedgerEvidenceAsync("polygonId");
Console.WriteLine(response);

Retrieve batch cryptographic evidence

Returns raw Hedera transaction IDs, state proofs, and Merkle root hashes for a consolidated EUDR batch. All anchoring is on the Hedera DLT layer.

Node.js

import { AgriBackupClient } from 'agribackup';

const client = new AgriBackupClient('sk_live_...');
const response = await client.evidence.getBatchLedgerEvidence('batchId');
console.log(response.data);

Python

from agribackup import AgriBackupClient

client = AgriBackupClient('sk_live_...')
response = client.evidence.get_batch_ledger_evidence('batchId')
print(response)

Java

import com.agribackup.AgriBackupClient;

AgriBackupClient client = new AgriBackupClient("sk_live_...");
var response = client.evidence.getBatchLedgerEvidence("batchId");
System.out.println(response);

C#

using AgriBackup;

var client = new AgriBackupClient("sk_live_...");
var response = await client.Evidence.GetBatchLedgerEvidenceAsync("batchId");
Console.WriteLine(response);

Retrieve finalized DDS payload

Returns the TRACES NT V3 XML payload and Hedera consensus timestamp once async DDS generation completes.

Node.js

import { AgriBackupClient } from 'agribackup';

const client = new AgriBackupClient('sk_live_...');
const response = await client.declarations.getDdsPayload('referenceId');
console.log(response.data);

Python

from agribackup import AgriBackupClient

client = AgriBackupClient('sk_live_...')
response = client.declarations.get_dds_payload('referenceId')
print(response)

Java

import com.agribackup.AgriBackupClient;

AgriBackupClient client = new AgriBackupClient("sk_live_...");
var response = client.declarations.getDdsPayload("referenceId");
System.out.println(response);

C#

using AgriBackup;

var client = new AgriBackupClient("sk_live_...");
var response = await client.Declarations.GetDdsPayloadAsync("referenceId");
Console.WriteLine(response);