lexicons and xrpc
lexicon
com.publicdomainrelay.temp.market.submitRfp
A requester submits an RFP to a bidder. The bidder records a bid intent and answers before it bids. Requires a service-auth JWT with lxm set to this NSID; the requester is the token issuer.
input
| field | type | description |
|---|---|---|
rfpUri * | string at-uri | The market.rfp record. |
rfpCid * | string cid | |
ingress | array of com.atproto.repo.strongRef | The com.publicdomainrelay.temp.ingress.webRTC offer records for this bidder. The bidder answers them in the reply with its own answer and listen records. |
output
| field | type | description |
|---|---|---|
ok * | boolean | |
name | string | The bid intent the bidder recorded. |
phase | string | The phase of the bid intent. |
declined | object | Present when this bidder will not bid on the RFP, found by the checks of the bid decision that need no wait. The intent is recorded and fails as before, except for a compute kind this bidder does not serve: that answer carries no intent (name is empty) and declined unservable. |
ingress | array of com.atproto.repo.strongRef | The bidder's com.publicdomainrelay.temp.ingress.webRTC answer and listen records for the request's offers, carrying the SDP and the bidder's STUN servers. |
errors
| error | description |
|---|---|
InvalidRequest | 400: the body is not JSON, or rfpUri or rfpCid is missing. |
Unauthorized | 401: the service-auth token is missing or not valid for this method. |
Forbidden | 403: the token's issuer may not submit this RFP. |
RFPClosed | 409: the RFP's bid window (10 minutes, counted on this route from the RFP's TID rkey, before the record is read) is over; the bidder records no intent. |
InternalError | 500: the bid intent could not be recorded. |
Unavailable | 503: the bidder is starting and cannot authorize or bid yet. |
Suspended | 503: the bidder operator suspended its participation (spec.suspendParticipation). |
used in
Compute Contract Flow - Complete Architecture Map, lexicons-market: one row per lexicon, market: the RFP flow
raw schema: lexicons/com/publicdomainrelay/temp/market/submitRfp.json
{
"lexicon": 1,
"id": "com.publicdomainrelay.temp.market.submitRfp",
"defs": {
"main": {
"type": "procedure",
"description": "A requester submits an RFP to a bidder. The bidder records a bid intent and answers before it bids. Requires a service-auth JWT with lxm set to this NSID; the requester is the token issuer.",
"input": {
"encoding": "application/json",
"schema": {
"type": "object",
"required": [
"rfpUri",
"rfpCid"
],
"properties": {
"rfpUri": {
"type": "string",
"format": "at-uri",
"description": "The market.rfp record."
},
"rfpCid": {
"type": "string",
"format": "cid"
},
"ingress": {
"type": "array",
"items": {
"type": "ref",
"ref": "com.atproto.repo.strongRef"
},
"description": "The com.publicdomainrelay.temp.ingress.webRTC offer records for this bidder. The bidder answers them in the reply with its own answer and listen records."
}
}
}
},
"output": {
"encoding": "application/json",
"schema": {
"type": "object",
"required": [
"ok"
],
"properties": {
"ok": {
"type": "boolean"
},
"name": {
"type": "string",
"description": "The bid intent the bidder recorded."
},
"phase": {
"type": "string",
"description": "The phase of the bid intent."
},
"declined": {
"type": "object",
"required": [
"kind",
"reason"
],
"description": "Present when this bidder will not bid on the RFP, found by the checks of the bid decision that need no wait. The intent is recorded and fails as before, except for a compute kind this bidder does not serve: that answer carries no intent (name is empty) and declined unservable.",
"properties": {
"kind": {
"type": "string",
"knownValues": [
"capacity",
"unservable"
],
"description": "capacity: the bidder is full now (its running and reserved guests leave no room, or its host lacks the memory), or cannot tell yet (its pinned guest image is not verified yet, the requested image's manifest could not be fetched just now): another round may find room. unservable: nothing but another bidder will do (the compute kind, nestedVirt, images, a size above its maxCpus or maxMem, an image it cannot fetch or verify, guest tools or net it does not serve). A requester that finds every bidder it asked unservable fails at once with the reasons; it waits for capacity while any bidder is full or did not answer."
},
"reason": {
"type": "string",
"description": "Why, as the bidder's own words."
}
}
},
"ingress": {
"type": "array",
"items": {
"type": "ref",
"ref": "com.atproto.repo.strongRef"
},
"description": "The bidder's com.publicdomainrelay.temp.ingress.webRTC answer and listen records for the request's offers, carrying the SDP and the bidder's STUN servers."
}
}
}
},
"errors": [
{
"name": "InvalidRequest",
"description": "400: the body is not JSON, or rfpUri or rfpCid is missing."
},
{
"name": "Unauthorized",
"description": "401: the service-auth token is missing or not valid for this method."
},
{
"name": "Forbidden",
"description": "403: the token's issuer may not submit this RFP."
},
{
"name": "RFPClosed",
"description": "409: the RFP's bid window (10 minutes, counted on this route from the RFP's TID rkey, before the record is read) is over; the bidder records no intent."
},
{
"name": "InternalError",
"description": "500: the bid intent could not be recorded."
},
{
"name": "Unavailable",
"description": "503: the bidder is starting and cannot authorize or bid yet."
},
{
"name": "Suspended",
"description": "503: the bidder operator suspended its participation (spec.suspendParticipation)."
}
]
}
}
}