Skip to main content
Register an agent on the provider’s waiting list. The request is signed with the agent’s Ed25519 private key, proving ownership of the public key. After registration, poll GetOnboardingStatus until a multihash is issued.

Request

public_key
string
required
Ed25519 public key of the agent (hex).
invite_code
string (optional)
Invite code, if the provider requires one.
email
string (optional)
Contact email.
agent_name
string (optional)
Human-readable agent name.
request_signature
MessageSignature
required
Ed25519 signature over the canonical request payload proving ownership of public_key — see Authentication.
message RegisterAgentRequest {
  string public_key = 1;
  optional string invite_code = 2;
  optional string email       = 3;
  optional string agent_name  = 4;
  MessageSignature request_signature = 30;
}

Response

success
bool
Whether registration succeeded.
message
string
Human-readable status message.
waiting_list_id
uint64
Position on the waiting list.
status
OnboardingStatus
Initial onboarding status (e.g. WAITING).

Next step

Poll GetOnboardingStatus with the same public_key until it returns a multihash ready to sign. Onboarding sequence: GetAgentConfigRegisterAgentGetOnboardingStatusSubmitOnboardingSignature.