Crate cow_app_data 

cow-app-data — Layer 2 CoW Protocol order app-data metadata schema and hash generation.

App-data is a bytes32 field in every CoW order that encodes a keccak256 hash of a JSON document describing the order’s intent, referral, UTM codes, interaction hooks, and more.

Submodules

Module	Purpose
types	Rust types matching the JSON schema (v1.14.0)
hash	Deterministic JSON serialisation and keccak256 hashing
cid	Bidirectional appDataHex ↔ IPFS CIDv1 conversion
ipfs	IPFS fetch/upload helpers and the MetadataApi facade
[schema]	Runtime JSON Schema validation against the bundled upstream spec
validation	Business-rule constraint checks (appCode length, bps caps, …)

Quick start

use cow_app_data::{AppDataDoc, MetadataApi};

let api = MetadataApi::new();
let doc = api.generate_app_data_doc("MyApp");
let info = api.get_app_data_info(&doc).unwrap();
println!("appData hex : {}", info.app_data_hex);
println!("CID         : {}", info.cid);

Building app-data for an order

use cow_app_data::{Metadata, Quote, build_app_data_doc, build_order_app_data};

// Simple: just an app code
let hex = build_order_app_data("MyDApp").unwrap();

// With metadata: slippage, partner fees, hooks, …
let meta = Metadata::default().with_quote(Quote::new(50));
let hex = build_app_data_doc("MyDApp", meta).unwrap();

Re-exports

pub use cid::app_data_hex_to_cid_legacy;Deprecated

pub use cid::CidComponents;

pub use cid::appdata_hex_to_cid;

pub use cid::assert_cid;

pub use cid::cid_to_appdata_hex;

pub use cid::decode_cid;

pub use cid::extract_digest;

pub use cid::parse_cid;

pub use hash::appdata_hex;

pub use hash::appdata_json;

pub use hash::build_app_data_doc;

pub use hash::build_app_data_doc_full;

pub use hash::build_order_app_data;

pub use hash::merge_app_data_doc;

pub use hash::stringify_deterministic;

pub use ipfs::AppDataInfo;

pub use ipfs::DEFAULT_IPFS_READ_URI;

pub use ipfs::DEFAULT_IPFS_WRITE_URI;

pub use ipfs::Ipfs;

pub use ipfs::IpfsUploadResult;

pub use ipfs::MetadataApi;

pub use ipfs::ValidationResult;

pub use ipfs::fetch_doc_from_app_data_hex;

pub use ipfs::fetch_doc_from_cid;

pub use ipfs::get_app_data_info;

pub use ipfs::get_app_data_schema;

pub use ipfs::import_schema;

pub use ipfs::upload_app_data_to_pinata;

pub use ipfs::upload_app_data_to_pinata as pin_json_in_pinata_ipfs;

pub use ipfs::validate_app_data_doc;

pub use ipfs::fetch_doc_from_app_data_hex_legacy;Deprecated

pub use ipfs::get_app_data_info_legacy;Deprecated

pub use ipfs::upload_metadata_doc_to_ipfs_legacy;Deprecated

pub use types::AppDataDoc;

pub use types::LATEST_APP_DATA_VERSION;

pub use types::LATEST_HOOKS_METADATA_VERSION;

pub use types::LATEST_ORDER_CLASS_METADATA_VERSION;

pub use types::LATEST_PARTNER_FEE_METADATA_VERSION;

pub use types::LATEST_QUOTE_METADATA_VERSION;

pub use types::LATEST_REFERRER_METADATA_VERSION;

pub use types::LATEST_REPLACED_ORDER_METADATA_VERSION;

pub use types::LATEST_SIGNER_METADATA_VERSION;

pub use types::LATEST_USER_CONSENTS_METADATA_VERSION;

pub use types::LATEST_UTM_METADATA_VERSION;

pub use types::LATEST_WIDGET_METADATA_VERSION;

pub use types::LATEST_WRAPPERS_METADATA_VERSION;

pub use types::Metadata;

pub use types::OrderClass;

pub use types::OrderClassKind;

pub use types::OrderInteractionHooks;

pub use types::PartnerFee;

pub use types::PartnerFeeEntry;

pub use types::Quote;

pub use types::Referrer;

pub use types::ReplacedOrder;

pub use types::Utm;

pub use types::Widget;

pub use types::get_partner_fee_bps;

Modules

cid

IPFS CIDv1 conversion helpers for CoW Protocol app-data.

hash

Canonical JSON → keccak256 hashing for CoW Protocol app-data.

ipfs

MetadataApi facade and IPFS fetch/upload helpers for CoW Protocol app-data.

types

App-data document types for CoW Protocol order metadata.

Structs

CowHook

A single CoW Protocol pre- or post-settlement interaction hook.

Enums

ValidationError

A specific constraint violation found when validating an AppDataDoc.