Lexicon Garden

com.publicdomainrelay.temp.gateway.requestComputeVM

Request a VM through the compute contract gateway. Gateway builds cloud-init from sshPublicKey, creates compute.vm and market.rfp records, discovers bidders, runs the full RFP protocol, submits accept, and verifies the receipt. Returns receipt refs and websocatUrl for SSH access.

Repository @johnandersen777.bsky.social did:plc:5svqtrhheairglgiiyvutzik namespace authority
Details · procedure
Kindprocedure
Authoritygateway.temp.publicdomainrelay.com
Indexed
Compare Edit in builder → Fork →

Procedure

procedure · POST

Input

application/json

bidWindowSec

integer

Seconds to wait for bids before picking a winner.

  • default: 30

computeVm

requiredref

Compute VM specification (cpus, mem, disk, network, role). user_data is populated by the gateway from sshPublicKey.

Reference

execProgram

string

Program to execute over SSH after VM is ready.

  • default: "bash"

extraBidderDids

array

Additional bidder DIDs beyond relay discovery.

itemsstring · did

keepVm

boolean

Skip VM teardown after contract completion.

  • default: true

policyMode

string

Fulfillment policy mode for bidder selection.

  • enum: only_me | direct_network | policy_based

skipSsh

boolean

Skip SSH session after contract. When true, returns immediately after receipt.

  • default: true

sshPublicKey

requiredstring

OpenSSH public key for root SSH access to the VM.

vmReadyTimeoutSec

integer

Seconds to wait for SSH readiness after provisioning.

Output

application/json

bids

array
itemsobject

error

string

receiptCid

string · cid

receiptOk

boolean

receiptUri

string · at-uri

rfpCid

string · cid

rfpUri

string · at-uri

sshExitCode

integer

sshReady

boolean

vmFqdn

string

websocatUrl

string · uri

winnerBidCid

string · cid

winnerBidUri

string · at-uri

winnerDid

string · did

Errors

InvalidRequest

No description in schema.

AuthRequired

No description in schema.

NoBidders

No description in schema.

ProvisioningFailed

No description in schema.