cdp_sdk::api::types

Struct X402DiscoveryResource

pub struct X402DiscoveryResource {Show 14 fields
    pub accepts: Vec<X402PaymentRequirements>,
    pub bundle_slugs: Vec<X402DiscoveryResourceBundleSlugsItem>,
    pub curated: Option<bool>,
    pub description: Option<String>,
    pub extensions: Map<String, Value>,
    pub icon_url: Option<Url>,
    pub last_updated: Option<DateTime<Utc>>,
    pub quality: Option<X402ResourceQuality>,
    pub resource: String,
    pub service_name: Option<String>,
    pub skill_url: Option<Url>,
    pub tags: Vec<String>,
    pub type_: X402DiscoveryResourceType,
    pub x402_version: X402Version,
}

Expand description

A single discovered x402 resource. Its fields come from three sources:

- **x402 protocol** — negotiated from the resource's payment-required response: `resource`,
  `type`, `x402Version`, `accepts`, `extensions`.
- **Provider-supplied** — metadata published by the resource owner: `description`,
  `serviceName`, `tags`.
- **Coinbase-derived** — added during ingestion and curation: `iconUrl`, `quality`,
  `lastUpdated`, and (for Coinbase-curated endpoints only) `curated`, `skillUrl` (a
  Coinbase-authored SKILL.md), and `bundleSlugs`.

JSON schema

{
 "description": "A single discovered x402 resource. Its fields come from three sources:\n\n- **x402 protocol** — negotiated from the resource's payment-required response: `resource`,\n  `type`, `x402Version`, `accepts`, `extensions`.\n- **Provider-supplied** — metadata published by the resource owner: `description`,\n  `serviceName`, `tags`.\n- **Coinbase-derived** — added during ingestion and curation: `iconUrl`, `quality`,\n  `lastUpdated`, and (for Coinbase-curated endpoints only) `curated`, `skillUrl` (a\n  Coinbase-authored SKILL.md), and `bundleSlugs`.\n",
 "type": "object",
 "required": [
   "resource",
   "type",
   "x402Version"
 ],
 "properties": {
   "accepts": {
     "description": "Payment requirements accepted by the resource.",
     "examples": [
       [
         {
           "amount": "1000000",
           "asset": "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
           "maxTimeoutSeconds": 60,
           "network": "eip155:8453",
           "payTo": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
           "scheme": "exact"
         }
       ]
     ],
     "type": "array",
     "items": {
       "$ref": "#/components/schemas/x402PaymentRequirements"
     }
   },
   "bundleSlugs": {
     "description": "Slugs of the curated x402 bundles this resource belongs to. A bundle is an ordered, named grouping of curated resources covering a common agent workflow. Present only for Coinbase-curated resources (`curated: true`); omitted when the resource is not curated or is not a member of any bundle.",
     "examples": [
       [
         "defi-trading"
       ]
     ],
     "type": "array",
     "items": {
       "type": "string",
       "maxLength": 64,
       "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
     },
     "maxItems": 50
   },
   "curated": {
     "description": "Whether this resource is a Coinbase-curated endpoint. Curated endpoints have passed the\npartner-admission and verification bar and surface higher in search and listing results.\nOmitted (treated as `false`) when the resource is not curated.\n",
     "examples": [
       true
     ],
     "type": "boolean"
   },
   "description": {
     "description": "A human-readable description of the resource.",
     "examples": [
       "Real-time weather forecast data"
     ],
     "type": "string"
   },
   "extensions": {
     "description": "Map of x402 protocol extensions supported by the resource, keyed by extension name.",
     "examples": [
       {
         "bazaar": {
           "info": {
             "input": {
               "method": "GET",
               "type": "http"
             }
           },
           "schema": {}
         }
       }
     ],
     "type": "object",
     "additionalProperties": true
   },
   "iconUrl": {
     "description": "URL of a square icon representing the service this resource belongs to. Distinct from a\nbrand logo: this is intended for compact, list-view rendering (favicon-style) and is\nnormalized to a square aspect ratio at ingestion. The image is moderated and re-hosted by\nCoinbase, so the URL is stable and safe to render directly in clients. Omitted when the\nprovider did not supply an icon, when the supplied icon failed moderation, or when image\nprocessing was unavailable at ingestion time.\n",
     "examples": [
       "https://res.cloudinary.com/bdb-prod/image/upload/..."
     ],
     "allOf": [
       {
         "$ref": "#/components/schemas/Url"
       }
     ]
   },
   "lastUpdated": {
     "description": "Timestamp of the last update.",
     "examples": [
       "2024-01-15T10:30:00Z"
     ],
     "type": "string",
     "format": "date-time"
   },
   "quality": {
     "$ref": "#/components/schemas/x402ResourceQuality"
   },
   "resource": {
     "description": "The URL of the resource.",
     "examples": [
       "https://api.example.com/weather/forecast"
     ],
     "type": "string"
   },
   "serviceName": {
     "description": "Display name of the service this resource belongs to. This is a free-form\nlabel for grouping and presentation only — it is not a stable identifier, and two resources\nsharing the same `serviceName` are not guaranteed to belong to the same logical service.\n",
     "examples": [
       "Weather API"
     ],
     "type": "string"
   },
   "skillUrl": {
     "description": "URL of the SKILL.md document describing how to use this resource. Omitted when the resource\nhas no associated skill document.\n",
     "examples": [
       "https://skills.cdp.coinbase.com/weather-api/SKILL.md"
     ],
     "allOf": [
       {
         "$ref": "#/components/schemas/Url"
       }
     ]
   },
   "tags": {
     "description": "Low-cardinality string labels associated with the resource for client-side\nfiltering and display. Values are free-form (no controlled vocabulary) and case-sensitive.\nOrder is not significant and duplicates are not expected.\n",
     "examples": [
       [
         "weather",
         "data"
       ]
     ],
     "type": "array",
     "items": {
       "type": "string"
     }
   },
   "type": {
     "description": "Communication protocol (e.g., \"http\", \"mcp\").",
     "examples": [
       "http"
     ],
     "type": "string",
     "enum": [
       "http",
       "mcp"
     ]
   },
   "x402Version": {
     "$ref": "#/components/schemas/X402Version"
   }
 }
}

Fields§

§accepts: Vec<X402PaymentRequirements>

Payment requirements accepted by the resource.

§bundle_slugs: Vec<X402DiscoveryResourceBundleSlugsItem>

Slugs of the curated x402 bundles this resource belongs to. A bundle is an ordered, named grouping of curated resources covering a common agent workflow. Present only for Coinbase-curated resources (curated: true); omitted when the resource is not curated or is not a member of any bundle.

§curated: Option<bool>

Whether this resource is a Coinbase-curated endpoint. Curated endpoints have passed the partner-admission and verification bar and surface higher in search and listing results. Omitted (treated as false) when the resource is not curated.

§description: Option<String>

A human-readable description of the resource.

§extensions: Map<String, Value>

Map of x402 protocol extensions supported by the resource, keyed by extension name.

§icon_url: Option<Url>

URL of a square icon representing the service this resource belongs to. Distinct from a brand logo: this is intended for compact, list-view rendering (favicon-style) and is normalized to a square aspect ratio at ingestion. The image is moderated and re-hosted by Coinbase, so the URL is stable and safe to render directly in clients. Omitted when the provider did not supply an icon, when the supplied icon failed moderation, or when image processing was unavailable at ingestion time.

§last_updated: Option<DateTime<Utc>>

Timestamp of the last update.

§quality: Option<X402ResourceQuality>§resource: String

The URL of the resource.

§service_name: Option<String>

Display name of the service this resource belongs to. This is a free-form label for grouping and presentation only — it is not a stable identifier, and two resources sharing the same serviceName are not guaranteed to belong to the same logical service.

§skill_url: Option<Url>

URL of the SKILL.md document describing how to use this resource. Omitted when the resource has no associated skill document.

§tags: Vec<String>

Low-cardinality string labels associated with the resource for client-side filtering and display. Values are free-form (no controlled vocabulary) and case-sensitive. Order is not significant and duplicates are not expected.

§type_: X402DiscoveryResourceType

Communication protocol (e.g., “http”, “mcp”).

§x402_version: X402Version

Struct X402DiscoveryResource Copy item path

Fields§

Implementations§

impl X402DiscoveryResource

pub fn builder() -> X402DiscoveryResource

Trait Implementations§

impl Clone for X402DiscoveryResource

fn clone(&self) -> Self

fn clone_from(&mut self, source: &Self)

impl Debug for X402DiscoveryResource

fn fmt(&self, f: &mut Formatter<'_>) -> Result

impl<'de> Deserialize<'de> for X402DiscoveryResource

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where __D: Deserializer<'de>,

impl From<&X402DiscoveryResource> for X402DiscoveryResource

fn from(value: &X402DiscoveryResource) -> Self

impl From<X402DiscoveryResource> for X402DiscoveryResource

fn from(value: X402DiscoveryResource) -> Self

impl Serialize for X402DiscoveryResource

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>where __S: Serializer,

impl TryFrom<X402DiscoveryResource> for X402DiscoveryResource

type Error = ConversionError

fn try_from(value: X402DiscoveryResource) -> Result<Self, ConversionError>

Auto Trait Implementations§

impl Freeze for X402DiscoveryResource

impl RefUnwindSafe for X402DiscoveryResource

impl Send for X402DiscoveryResource

impl Sync for X402DiscoveryResource

impl Unpin for X402DiscoveryResource

impl UnsafeUnpin for X402DiscoveryResource

impl UnwindSafe for X402DiscoveryResource

Blanket Implementations§

impl<T> Any for Twhere T: 'static + ?Sized,

fn type_id(&self) -> TypeId

impl<T> Borrow<T> for Twhere T: ?Sized,

fn borrow(&self) -> &T

impl<T> BorrowMut<T> for Twhere T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

impl<T> CloneToUninit for Twhere T: Clone,

unsafe fn clone_to_uninit(&self, dest: *mut u8)

impl<T> DeserializeOwned for Twhere T: for<'de> Deserialize<'de>,

impl<T> From<T> for T

fn from(t: T) -> T

impl<T> Instrument for T

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

fn in_current_span(self) -> Instrumented<Self> ⓘ

impl<T, U> Into<U> for Twhere U: From<T>,

fn into(self) -> U

impl<T> PolicyExt for Twhere T: ?Sized,

fn and<P, B, E>(self, other: P) -> And<T, P>where T: Sized + Policy<B, E>, P: Policy<B, E>,

fn or<P, B, E>(self, other: P) -> Or<T, P>where T: Sized + Policy<B, E>, P: Policy<B, E>,

impl<T> Same for T

type Output = T

impl<T> ToOwned for Twhere T: Clone,

type Owned = T

fn to_owned(&self) -> T

fn clone_into(&self, target: &mut T)

impl<T, U> TryFrom<U> for Twhere U: Into<T>,

type Error = !

fn try_from(value: U) -> Result<T, !>

impl<T, U> TryInto<U> for Twhere U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

impl<V, T> VZip<V> for Twhere V: MultiLane<T>,

fn vzip(self) -> V

impl<T> WithSubscriber for T

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘwhere S: Into<Dispatch>,

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Struct X402DiscoveryResource

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
where __D: Deserializer<'de>,

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
where S: Serializer,

impl<T> Any for T
where T: 'static + ?Sized,

impl<T> Borrow<T> for T
where T: ?Sized,

impl<T> BorrowMut<T> for T
where T: ?Sized,

impl<T> CloneToUninit for T
where T: Clone,

impl<T> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,

impl<T, U> Into<U> for T
where U: From<T>,

impl<T> PolicyExt for T
where T: ?Sized,

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

impl<T> ToOwned for T
where T: Clone,

impl<T, U> TryFrom<U> for T
where U: Into<T>,

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,