Archive verification
Get known-node archive evidence
Path Parameters
publicKey*string
Query Parameters
archiveUrl?string
Restrict all evidence pages to one archive root owned by the requested entity.
Format
uricopyLimit?integer
Maximum verified-copy rows in each same-organization and network sample. Set 0 to skip optional copy discovery. Counts are null when not requested or temporarily unavailable; source failures still return.
Range
0 <= value <= 10Default
3objectCursor?string
Opaque cursor for the next object page. Cursors are bound to the entity, archive root, and object filters.
Length
length <= 1024objectLimit?integer
Range
0 <= value <= 250Default
25objectStatus?string
Value in
- "pending"
- "scanning"
- "verified"
- "failed"
objectType?string
Value in
- "history-archive-state"
- "checkpoint-state"
- "ledger"
- "transactions"
- "results"
- "scp"
- "bucket"
eventCursor?string
Opaque cursor for the next object-event page. Cursors are bound to the entity, archive root, and event filters.
Length
length <= 1024eventEvidenceClass?string
Value in
- "archive-object"
- "worker-infrastructure"
- "coordinator-infrastructure"
eventLimit?integer
Range
0 <= value <= 250Default
25eventObjectType?string
Value in
- "history-archive-state"
- "checkpoint-state"
- "ledger"
- "transactions"
- "results"
- "scp"
- "bucket"
eventType?string
Value in
- "claimed"
- "heartbeat"
- "verified"
- "failed"
- "released"
failureCursor?string
Opaque cursor for the next remote archive-failure page.
Length
length <= 1024failureLimit?integer
Range
0 <= value <= 250Default
25failureObjectType?string
Restrict both remote archive failures and worker issues to one object type.
Value in
- "history-archive-state"
- "checkpoint-state"
- "ledger"
- "transactions"
- "results"
- "scp"
- "bucket"
workerIssueCursor?string
Opaque cursor for the next worker/coordinator infrastructure-issue page.
Length
length <= 1024workerIssueLimit?integer
Range
0 <= value <= 250Default
25Response Body
application/json
curl -X GET "https://example.com/v1/known/nodes/string/archive-evidence"{ "eventPage": { "events": [ { "archiveUrl": "http://example.com", "archiveUrlIdentity": "string", "bucketHash": "string", "bytesDownloaded": 0, "checkpointLedger": 0, "claimAttempt": 1, "createdAt": "2019-08-24T14:15:22Z", "error": { "message": "string", "type": "string", "httpStatus": 0 }, "eventType": "claimed", "evidenceClass": "archive-object", "nextAttemptAt": "2019-08-24T14:15:22Z", "objectKey": "string", "objectRemoteId": "230cf7cb-3bab-414f-83f3-cc6c8b830aa4", "objectType": "history-archive-state", "objectUrl": "http://example.com", "remoteId": "cdee4406-f055-4129-bba8-6e5385434edd", "verificationFacts": {}, "workerStage": "string" } ], "filters": { "archiveUrlIdentity": "string", "evidenceClass": "archive-object", "eventType": "claimed", "objectType": "history-archive-state" }, "page": { "hasMore": true, "limit": 1, "nextCursor": "string", "snapshotAt": "2019-08-24T14:15:22Z", "total": 0 } }, "generatedAt": "2019-08-24T14:15:22Z", "nodePublicKeys": [ "string" ], "objectPage": { "filters": { "archiveUrlIdentity": "string", "objectType": "history-archive-state", "status": "pending" }, "objects": [ { "archiveUrl": "http://example.com", "archiveUrlIdentity": "string", "objectKey": "string", "objectType": "history-archive-state", "objectUrl": "http://example.com", "remoteId": "cdee4406-f055-4129-bba8-6e5385434edd", "status": "pending", "workerStage": "string", "checkpointLedger": 0, "bucketHash": "string", "bytesDownloaded": 0, "attempts": 0, "delayReason": { "code": "archive-active-cap", "until": "2019-08-24T14:15:22Z" }, "nextAttemptAt": "2019-08-24T14:15:22Z", "refreshAfter": "2019-08-24T14:15:22Z", "claimedAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "verificationFacts": {}, "verifiedAt": "2019-08-24T14:15:22Z", "error": { "message": "string", "type": "string", "httpStatus": 0 } } ], "page": { "hasMore": true, "limit": 1, "nextCursor": "string", "snapshotAt": "2019-08-24T14:15:22Z", "total": 0 } }, "remoteFailures": { "failures": [ { "networkVerifiedCopies": { "copies": [ { "archiveUrl": "http://example.com", "archiveUrlIdentity": "string", "objectUrl": "http://example.com", "remoteId": "cdee4406-f055-4129-bba8-6e5385434edd", "verifiedAt": "2019-08-24T14:15:22Z" } ], "count": 0, "lookupStatus": "available", "sampleLimit": 0 }, "object": { "archiveUrl": "http://example.com", "archiveUrlIdentity": "string", "objectKey": "string", "objectType": "history-archive-state", "objectUrl": "http://example.com", "remoteId": "cdee4406-f055-4129-bba8-6e5385434edd", "status": "pending", "workerStage": "string", "checkpointLedger": 0, "bucketHash": "string", "bytesDownloaded": 0, "attempts": 0, "delayReason": { "code": "archive-active-cap", "until": "2019-08-24T14:15:22Z" }, "nextAttemptAt": "2019-08-24T14:15:22Z", "refreshAfter": "2019-08-24T14:15:22Z", "claimedAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "verificationFacts": {}, "verifiedAt": "2019-08-24T14:15:22Z", "error": { "message": "string", "type": "string", "httpStatus": 0 } }, "sameOrganizationVerifiedCopies": { "copies": [ { "archiveUrl": "http://example.com", "archiveUrlIdentity": "string", "objectUrl": "http://example.com", "remoteId": "cdee4406-f055-4129-bba8-6e5385434edd", "verifiedAt": "2019-08-24T14:15:22Z" } ], "count": 0, "lookupStatus": "available", "sampleLimit": 0 } } ], "filters": { "archiveUrlIdentity": "string", "objectType": "history-archive-state" }, "hasMore": true, "limit": 1, "nextCursor": "string", "snapshotAt": "2019-08-24T14:15:22Z", "total": 0 }, "roots": [ { "archiveUrl": "http://example.com", "archiveUrlIdentity": "string", "checkpoints": { "mismatchedCheckpoints": 0, "notEvaluableCheckpoints": 0, "pendingCheckpoints": 0, "totalCheckpoints": 0, "verifiedCheckpoints": 0 }, "latestObjectAt": "2019-08-24T14:15:22Z", "nodePublicKeys": [ "string" ], "objects": { "activeObjects": 0, "bucketObjects": 0, "pendingObjects": 0, "remoteFailureObjects": 0, "totalObjects": 0, "verifiedBucketObjects": 0, "verifiedObjects": 0, "workerIssueObjects": 0 }, "scannerOwnedState": { "archiveUrl": "http://example.com", "archiveUrlIdentity": "string", "stateUrl": "http://example.com", "status": "available", "observedAt": "2019-08-24T14:15:22Z", "source": "backfill", "metadata": { "stellarHistoryUrl": "http://example.com", "observedAt": "2019-08-24T14:15:22Z", "stellarHistory": { "version": 0, "server": "string", "currentLedger": 0, "networkPassphrase": "string", "currentBuckets": [ { "curr": "string", "snap": "string", "next": { "state": 0, "output": "string" } } ], "hotArchiveBuckets": [ { "curr": "string", "snap": "string", "next": { "state": 0, "output": "string" } } ] } }, "failure": { "message": "string", "type": "string", "httpStatus": 0 }, "latestFailure": { "message": "string", "type": "string", "httpStatus": 0, "observedAt": "2019-08-24T14:15:22Z", "source": "backfill" } } } ], "totals": { "archiveRoots": 0, "checkpoints": { "mismatchedCheckpoints": 0, "notEvaluableCheckpoints": 0, "pendingCheckpoints": 0, "totalCheckpoints": 0, "verifiedCheckpoints": 0 }, "nodes": 0, "objects": { "activeObjects": 0, "bucketObjects": 0, "pendingObjects": 0, "remoteFailureObjects": 0, "totalObjects": 0, "verifiedBucketObjects": 0, "verifiedObjects": 0, "workerIssueObjects": 0 } }, "workerIssues": { "filters": { "archiveUrlIdentity": "string", "objectType": "history-archive-state" }, "hasMore": true, "issues": [ { "evidenceClass": "worker-infrastructure", "object": { "archiveUrl": "http://example.com", "archiveUrlIdentity": "string", "objectKey": "string", "objectType": "history-archive-state", "objectUrl": "http://example.com", "remoteId": "cdee4406-f055-4129-bba8-6e5385434edd", "status": "pending", "workerStage": "string", "checkpointLedger": 0, "bucketHash": "string", "bytesDownloaded": 0, "attempts": 0, "delayReason": { "code": "archive-active-cap", "until": "2019-08-24T14:15:22Z" }, "nextAttemptAt": "2019-08-24T14:15:22Z", "refreshAfter": "2019-08-24T14:15:22Z", "claimedAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "verificationFacts": {}, "verifiedAt": "2019-08-24T14:15:22Z", "error": { "message": "string", "type": "string", "httpStatus": 0 } } } ], "limit": 1, "nextCursor": "string", "snapshotAt": "2019-08-24T14:15:22Z", "total": 0 }, "organizationId": "string", "publicKey": "string"}