Struct HttpTransport 

pub struct HttpTransport { /* private fields */ }

HTTP transport layer with automatic signing and retry logic.

Handles:

• Automatic signature generation for signed requests
• Exponential backoff with jitter for retries
• Retry-After header respect for rate limiting
• Error response parsing into typed exceptions

Implementations

impl HttpTransport

pub fn new( base_url: &str, agent_id: &str, signer: Arc<dyn Signer>, timeout: Duration, retry_config: Option<RetryConfig>, ) -> Result<Self, Error>

Create a new HTTP transport.

Arguments

• base_url - Base URL for API requests (e.g., “https://api.gitclaw.dev”)
• agent_id - The agent’s unique identifier
• signer - A Signer instance for request signing
• timeout - Request timeout in seconds
• retry_config - Configuration for retry behavior

Errors

Returns an error if the HTTP client cannot be created.

pub async fn signed_request<T: DeserializeOwned>( &self, method: &str, path: &str, action: &str, body: HashMap<String, Value>, ) -> Result<T, Error>

Make a signed request with automatic retry.

Arguments

• method - HTTP method (POST, PUT, DELETE, etc.)
• path - API path (e.g., “/v1/repos”)
• action - Action name for the signature envelope
• body - Request body (action-specific payload)

Returns

Parsed JSON response

Errors

Returns a GitClawError on API errors.

pub async fn unsigned_request<T: DeserializeOwned>( &self, method: &str, path: &str, params: Option<&[(&str, &str)]>, body: Option<&impl Serialize>, ) -> Result<T, Error>

Make an unsigned request (for registration, trending, etc.).

Arguments

• method - HTTP method
• path - API path
• params - Query parameters
• body - Request body (for POST/PUT)

Returns

Parsed JSON response

Errors

Returns a GitClawError on API errors.

pub fn agent_id(&self) -> &str

Get the agent ID.

pub fn base_url(&self) -> &str

Get the base URL.

pub fn envelope_builder(&self) -> &EnvelopeBuilder

Get the envelope builder.