# DATA Foundation Docs ## Docs - [Introduction](https://docs.datafdn.org/introduction.md): The DATA Foundation: prove where data came from, keep it confidential, and define the rights over it. - [Quickstart](https://docs.datafdn.org/quickstart.md): Start building on the DATA Foundation quickly. - [FAQ](https://docs.datafdn.org/faq.md): Get answers to the most common questions about the DATA Foundation as a whole. - [Trace Overview](https://docs.datafdn.org/trace/overview.md): Verifiable, provider-normalized provenance for data registered on the DATA Foundation. - [CDR Overview](https://docs.datafdn.org/cdr/overview.md): Threshold-encrypted, on-chain-gated confidentiality for data registered on the DATA Foundation. - [Overview](https://docs.datafdn.org/concepts/overview.md): A broad overview of the DATA Foundation's "Proof-of-Creativity" protocol. - [🧩 IP Asset](https://docs.datafdn.org/concepts/ip-asset/overview.md): The foundational programmable IP metadata on the DATA Foundation - [⚙️ IP Account](https://docs.datafdn.org/concepts/ip-asset/ip-account.md): A modified ERC-6551 implementation bound to an IP Asset - [IP Modifications & Restrictions](https://docs.datafdn.org/concepts/ip-asset/ipa-modifications.md): Learn about the modifications and restrictions for IP Assets - [📝 IPA Metadata Standard](https://docs.datafdn.org/concepts/ip-asset/ipa-metadata-standard.md): An overview of the IP-specific metadata standard - [📜 Licensing Module](https://docs.datafdn.org/concepts/licensing-module/overview.md): Learn about creating & attaching real legal license to your IP on the DATA Foundation - [License Template](https://docs.datafdn.org/concepts/licensing-module/license-template.md): A legal framework, written in code ("programmable"), that defines various licensing terms for an IP - [License Terms](https://docs.datafdn.org/concepts/licensing-module/license-terms.md): A particular combination of values from a License Template that define how others can interact with your IP - [License Token](https://docs.datafdn.org/concepts/licensing-module/license-token.md): An ERC-721 NFT that allows you to register your IP as a derivative of another, based on the License Terms defined in the token - [License Config](https://docs.datafdn.org/concepts/licensing-module/license-config.md): An optional config that can be attached to a specific license for dynamic minting fees and custom logic. - [💊 Programmable IP License (PIL)](https://docs.datafdn.org/concepts/programmable-ip-license/overview.md): The DATA Foundation Programmable IP License - A legal framework for IP licensing on-chain - [PIL Terms](https://docs.datafdn.org/concepts/programmable-ip-license/pil-terms.md): Detailed explanation of all terms available in the Programmable IP License - [PIL Flavors (examples)](https://docs.datafdn.org/concepts/programmable-ip-license/pil-flavors.md): Pre-configured License Terms for ease of use - [🪝 Hooks](https://docs.datafdn.org/concepts/hooks.md): Add custom logic before minting license tokens or registering derivatives. - [📦 SPG (Periphery)](https://docs.datafdn.org/concepts/spg/overview.md): Learn about the DATA Foundation Gateway that simplifies interactions with the protocol - [Batch Function Calls](https://docs.datafdn.org/concepts/spg/batch-spg-function-calls.md): Learn how to batch multiple operations into a single transaction for efficiency - [Welcome to the DATA Network](https://docs.datafdn.org/network/overview.md) - [Mainnet](https://docs.datafdn.org/network/connect/mainnet.md): Information and Resources for the DATA Network - [Aeneid testnet](https://docs.datafdn.org/network/connect/aeneid.md): Information and resources for the Aeneid testnet - [Learn about the DATA Foundation](https://docs.datafdn.org/network/learn/overview.md) - [Whitepaper](https://docs.datafdn.org/network/learn/whitepaper.md) - [Learn about the DATA Foundation's node software](https://docs.datafdn.org/network/learn/node-software/overview.md) - [Execution Layer (EL)](https://docs.datafdn.org/network/learn/node-software/execution_layer.md) - [Consensus Layer (CL)](https://docs.datafdn.org/network/learn/node-software/consensus_layer.md) - [Engine API](https://docs.datafdn.org/network/learn/node-software/engine_api.md) - [Overview](https://docs.datafdn.org/network/learn/node-software/cosmos-modules/cosmos-module-overview.md): List of all production-grade modules used on the DATA Network - [EVM engine module](https://docs.datafdn.org/network/learn/node-software/cosmos-modules/evmengine-module.md): Module that facilitates communication between consensus and execution layers - [EVM staking module](https://docs.datafdn.org/network/learn/node-software/cosmos-modules/evmstaking-module.md): Module that facilitates consensus layer staking-related logic - [Token Minting Module](https://docs.datafdn.org/network/learn/node-software/cosmos-modules/mint-module.md): Module responsible for token minting and inflation in the DATA Network - [Staking Module](https://docs.datafdn.org/network/learn/node-software/cosmos-modules/staking-module.md): Modified staking module with reward multipliers for locked and unlocked tokens - [Run a localnet](https://docs.datafdn.org/network/learn/node-software/localnet.md): Guide to setting up and running a local DATA Network for development and testing - [Precompiles](https://docs.datafdn.org/network/learn/node-software/precompiled-contracts.md): Specialized smart contracts implemented in the DATA Foundation's execution layer - [Staking Design](https://docs.datafdn.org/network/learn/token-economy.md): Detailed overview of the DATA Network's staking mechanics and tokenomics - [Participate](https://docs.datafdn.org/network/participate/overview.md) - [Overview](https://docs.datafdn.org/network/participate/validators/overview.md): Guide to running a validator node on the DATA Network - [Full Node](https://docs.datafdn.org/network/participate/validators/node-setup-mainnet.md): Guide to setting up a DATA Foundation node for mainnet - [Operating Your Node](https://docs.datafdn.org/network/participate/validators/operate-your-node.md): Guide to operating and maintaining your DATA Foundation node - [Node Upgrade](https://docs.datafdn.org/network/participate/validators/node-upgrade.md): Guide to upgrading your DATA Foundation node clients - [DKG Validator Guide](https://docs.datafdn.org/network/participate/validators/dkg/dkg-validator-guide.md): Guide to setting up and running story-kernel for DKG committee participation - [Kernel Upgrade](https://docs.datafdn.org/network/participate/validators/dkg/kernel-upgrade.md): Guide to upgrading the story-kernel binary on DKG committee validators - [Release Notes](https://docs.datafdn.org/network/participate/validators/release-notes.md): Information on DATA Foundation execution and consensus client software releases - [Troubleshooting](https://docs.datafdn.org/network/participate/validators/troubleshooting.md): Common problems and solutions when running DATA Foundation nodes - [Governance](https://docs.datafdn.org/network/participate/governance.md) - [Forum](https://docs.datafdn.org/network/participate/forum.md) - [DATA Foundation Proposals](https://docs.datafdn.org/network/participate/sip.md) - [Disclaimers](https://docs.datafdn.org/notices.md) - [Dev Overview](https://docs.datafdn.org/developers/overview.md): For developers who want to build on our protocol. - [Deployed Smart Contracts](https://docs.datafdn.org/developers/deployed-smart-contracts.md): A list of all deployed protocol addresses - [Releases](https://docs.datafdn.org/developers/releases.md): Links to all Story releases - [CDR SDK Overview](https://docs.datafdn.org/developers/cdr-sdk/overview.md): Learn how to integrate Confidential Data Rails (CDR) into your application using the CDR SDK. - [Setup CDR Client](https://docs.datafdn.org/developers/cdr-sdk/setup.md): Learn how to install and configure the CDR SDK. - [Encrypt & Decrypt](https://docs.datafdn.org/developers/cdr-sdk/encrypt-and-decrypt.md): Learn how to encrypt a secret and decrypt it using CDR threshold decryption. - [IP Asset Vaults](https://docs.datafdn.org/developers/cdr-sdk/ip-asset-vaults.md): Learn how to create CDR vaults backed by IP Assets that require license tokens to decrypt. - [Runtime Configuration](https://docs.datafdn.org/developers/cdr-sdk/advanced-configuration.md): DATA Foundation API endpoint, DKG state, threshold tuning, system addresses, and Aeneid runtime notes for the CDR SDK. - [Trace Integration Guide](https://docs.datafdn.org/trace/integration.md): How any data provider registers records, submits metadata updates, and reads public audit views through the Trace API. - [Overview](https://docs.datafdn.org/developers/typescript-sdk/overview.md): For TypeScript developers who want to build with the DATA Foundation. - [Setup Client](https://docs.datafdn.org/developers/typescript-sdk/setup.md): Learn how to setup the TypeScript SDK. - [Register an IP Asset](https://docs.datafdn.org/developers/typescript-sdk/register-ip-asset.md): Learn how to Register an NFT as an IP Asset in TypeScript. - [Attach Terms to an IPA](https://docs.datafdn.org/developers/typescript-sdk/attach-terms.md): Learn how to Attach License Terms to an IP Asset in TypeScript. - [Mint a License Token](https://docs.datafdn.org/developers/typescript-sdk/mint-license.md): Learn how to mint a License Token from an IP Asset in TypeScript. - [React Guide](https://docs.datafdn.org/developers/react-guide/overview.md): Learn how to integrate the TypeScript SDK to work with React-based apps. - [React Setup](https://docs.datafdn.org/developers/react-guide/setup/overview.md): Learn how to setup the TypeScript SDK in React. - [Dynamic Setup](https://docs.datafdn.org/developers/react-guide/setup/dynamic-setup.md): Learn how to setup Dynamic Wallet in your DATA Foundation DApp. - [RainbowKit Setup](https://docs.datafdn.org/developers/react-guide/setup/rainbowkit-setup.md): Learn how to setup RainbowKit Wallet in your DATA Foundation DApp. - [Reown (WalletConnect) Setup](https://docs.datafdn.org/developers/react-guide/setup/reown-setup.md): Learn how to setup Reown (WalletConnect) in your DATA Foundation DApp. - [Tomo Setup](https://docs.datafdn.org/developers/react-guide/setup/tomo-setup.md): Learn how to setup TomoEVMKit in your DATA Foundation DApp. - [Using the SDK in React](https://docs.datafdn.org/developers/react-guide/using-the-sdk-in-react.md): Learn how to use the SDK in React once you have it set up. - [Smart Contract Guide](https://docs.datafdn.org/developers/smart-contracts-guide/overview.md): For smart contract developers who wish to build on top of the DATA Foundation directly. - [Setup](https://docs.datafdn.org/developers/smart-contracts-guide/setup.md): Set up your development environment for DATA Foundation smart contracts. - [Register an IP Asset](https://docs.datafdn.org/developers/smart-contracts-guide/register-ip-asset.md): Learn how to Register an NFT as an IP Asset in Solidity. - [Register License Terms](https://docs.datafdn.org/developers/smart-contracts-guide/register-terms.md): Learn how to create new License Terms in Solidity. - [Attach Terms to an IPA](https://docs.datafdn.org/developers/smart-contracts-guide/attach-terms.md): Learn how to attach License Terms to an IP Asset in Solidity. - [Mint a License Token](https://docs.datafdn.org/developers/smart-contracts-guide/mint-license.md): Learn how to mint a License Token from an IPA in Solidity. - [Using an Example](https://docs.datafdn.org/developers/smart-contracts-guide/example.md): Combine all of our tutorials together in a practical example. - [Global Wallet](https://docs.datafdn.org/developers/global-wallet/overview.md): Use DATA Foundation's Global Wallet to enable Dynamic social login in your app. - [How to Register IP on the DATA Foundation](https://docs.datafdn.org/developers/tutorials/how-to-register-ip.md): Learn how to register an NFT as IP with proper metadata on the DATA Foundation. - [How to Register Music on the DATA Foundation](https://docs.datafdn.org/developers/tutorials/how-to-register-music.md): Learn how to properly register music on the DATA Foundation as an IP Asset using the Typescript SDK. - [Email Login & Sponsored Transactions with Privy](https://docs.datafdn.org/developers/tutorials/privy-tutorial.md): Learn how to implement email logins and sponsored transactions with Privy & Pimlico. - [Easy $DATA Onboarding](https://docs.datafdn.org/developers/tutorials/easy-ip-onboarding.md): An example of how to integrate purchasing $DATA with Apple Pay, Venmo, Debit Card, Bank, and more with Halliday. - [SDK Reference Overview](https://docs.datafdn.org/sdk-reference/overview.md): Overview of all available DATA Foundation TypeScript SDKs - [CDR SDK Reference Overview](https://docs.datafdn.org/sdk-reference/cdr/overview.md): A detailed description of every function in the CDR SDK - [Observer](https://docs.datafdn.org/sdk-reference/cdr/observer.md): Read-only methods for querying CDR vault data, fees, and DKG state. - [Uploader](https://docs.datafdn.org/sdk-reference/cdr/uploader.md): Methods for encrypting data and writing it to CDR vaults. - [Consumer](https://docs.datafdn.org/sdk-reference/cdr/consumer.md): Methods for requesting and performing CDR decryption. - [Crypto Utilities](https://docs.datafdn.org/sdk-reference/cdr/crypto.md): Low-level TDH2 and ECIES cryptographic primitives used by the CDR SDK. - [IP Asset](https://docs.datafdn.org/sdk-reference/ipasset.md): IPAssetClient allows you to create, get, and list IP Assets within the DATA Foundation. - [IP Account](https://docs.datafdn.org/sdk-reference/ipaccount.md): IPAccountClient allows you to manage IP Account metadata and execute transactions. - [License](https://docs.datafdn.org/sdk-reference/license.md): LicenseClient allows you to manage license terms and tokens within the DATA Foundation. - [Permissions](https://docs.datafdn.org/sdk-reference/permissions.md): PermissionClient allows you to manage permissions for IP Accounts within the DATA Foundation. - [NFT Client](https://docs.datafdn.org/sdk-reference/nftclient.md): Used to mint a new SPG collection for use with the DATA Foundation. - [WIP Client](https://docs.datafdn.org/sdk-reference/wipclient.md): Used to handle the wrapping/unwrapping of WIP (Wrapped IP) tokens within the DATA Foundation. - [SDK Reference Overview](https://docs.datafdn.org/sdk-reference/python/overview.md): A detailed description of every function in our Python SDK - [IP Asset](https://docs.datafdn.org/sdk-reference/python/ipasset.md): IPAsset allows you to create, get, and list IP Assets within the DATA Foundation. - [IP Account](https://docs.datafdn.org/sdk-reference/python/ipaccount.md): IPAccount allows you to manage IP Account metadata and execute transactions. - [License](https://docs.datafdn.org/sdk-reference/python/license.md): License allows you to manage license terms and tokens within the DATA Foundation. - [Permissions](https://docs.datafdn.org/sdk-reference/python/permissions.md): Permission allows you to manage permissions for IP Accounts within the DATA Foundation. - [NFT Client](https://docs.datafdn.org/sdk-reference/python/nftclient.md): Used to mint a new SPG collection for use with the DATA Foundation. - [WIP](https://docs.datafdn.org/sdk-reference/python/wipclient.md): Used to handle the wrapping/unwrapping of WIP (Wrapped IP) tokens within the DATA Foundation. - [Introduction](https://docs.datafdn.org/api-reference/protocol/introduction.md): Example section for showcasing API endpoints - [Blockscout API](https://docs.datafdn.org/api-reference/blockscout-api.md): Get gas price, average block time, market cap, token price, and more. - [List IP Assets](https://docs.datafdn.org/api-reference/protocol-v4/list-ip-assets.md): Retrieve a list of IP assets with pagination and filtering options. The 'where' field is optional and should only be provided when filtering by specific IP IDs, owner address, or token contract address. This endpoint can also be used to fetch a single asset by passing its ID in the ipIds filter. - [List IP Asset Edges](https://docs.datafdn.org/api-reference/protocol-v4/list-ip-asset-edges.md): Retrieve a list of edges (derivative registered events) that represent relationships between IP assets. These edges show parent-child relationships formed through licensing. - [List Collections](https://docs.datafdn.org/api-reference/protocol-v4/list-collections.md): Retrieve a list of collections with pagination and filtering options. Collections can be ordered by updatedAt, assetCount, or licensesCount (asc/desc). Collections are automatically enriched with metadata. The 'where' field is optional and should only be provided when filtering by specific collectio… - [Get License Tokens](https://docs.datafdn.org/api-reference/protocol-v4/get-license-tokens.md): Retrieve license tokens with optional filtering. If no filters are provided, returns all license tokens. Supports filtering by owner wallet address and/or licensor IP ID. Results are paginated and can be ordered by 'blockNumber' (default: descending). - [Search IP Assets](https://docs.datafdn.org/api-reference/protocol/search.md): Perform vector search for IP assets based on query text and optional media type filter. This endpoint uses AI-powered search to find relevant assets by semantic similarity. - [List IP Transactions](https://docs.datafdn.org/api-reference/protocol/transactions.md): Retrieve a list of IP transactions with pagination and filtering options. The ‘where’ field is optional and should only be provided when filtering by specific transaction hashes, event types, or block ranges. This endpoint can also be used to fetch specific transactions by passing their hashes in th… - [Introduction](https://docs.datafdn.org/api-reference/consensus-client/introduction.md): Example section for showcasing API endpoints - [GetValidators](https://docs.datafdn.org/api-reference/cosmos-originstaking/getvalidators.md) - [GetValidatorByValidatorAddress](https://docs.datafdn.org/api-reference/cosmos-originstaking/getvalidatorbyvalidatoraddress.md) - [GetValidatorDelegationsByValidatorAddress](https://docs.datafdn.org/api-reference/cosmos-originstaking/getvalidatordelegationsbyvalidatoraddress.md) - [GetDelegationsByDelegatorAddress](https://docs.datafdn.org/api-reference/cosmos-originstaking/getdelegationsbydelegatoraddress.md) - [GetRedelegationsByDelegatorAddress](https://docs.datafdn.org/api-reference/cosmos-originstaking/getredelegationsbydelegatoraddress.md) - [GetValidatorsByDelegatorAddress](https://docs.datafdn.org/api-reference/cosmos-originstaking/getvalidatorsbydelegatoraddress.md) - [GetValidatorsByDelegatorAddressValidatorAddress](https://docs.datafdn.org/api-reference/cosmos-originstaking/getvalidatorsbydelegatoraddressvalidatoraddress.md) - [GetUnbondingDelegationsByDelegatorAddress](https://docs.datafdn.org/api-reference/cosmos-originstaking/getunbondingdelegationsbydelegatoraddress.md) - [GetStakingParams](https://docs.datafdn.org/api-reference/cosmos-originstaking/getstakingparams.md) - [GetStakingPool](https://docs.datafdn.org/api-reference/cosmos-originstaking/getstakingpool.md) - [GetHistoricalInfoByHeight](https://docs.datafdn.org/api-reference/cosmos-originstaking/gethistoricalinfobyheight.md) - [GetDelegationByValidatorAddressDelegatorAddress](https://docs.datafdn.org/api-reference/cosmos-originstaking/getdelegationbyvalidatoraddressdelegatoraddress.md) - [GetValidatorUnbondingDelegations](https://docs.datafdn.org/api-reference/cosmos-originstaking/getvalidatorunbondingdelegations.md) - [GetDelegatorUnbondingDelegation](https://docs.datafdn.org/api-reference/cosmos-originstaking/getdelegatorunbondingdelegation.md) - [GetAuthParams](https://docs.datafdn.org/api-reference/cosmos-originauth/getauthparams.md) - [GetBankParams](https://docs.datafdn.org/api-reference/cosmos-originbank/getbankparams.md) - [GetSupplyByDenom](https://docs.datafdn.org/api-reference/cosmos-originbank/getsupplybydenom.md) - [GetBalancesByAddressDenom](https://docs.datafdn.org/api-reference/cosmos-originbank/getbalancesbyaddressdenom.md) - [GetSpendableBalancesByAddressDenom](https://docs.datafdn.org/api-reference/cosmos-originbank/getspendablebalancesbyaddressdenom.md) - [GetDistributionParams](https://docs.datafdn.org/api-reference/cosmos-origindistribution/getdistributionparams.md) - [GetDistributionValidatorsByDelegatorAddress](https://docs.datafdn.org/api-reference/cosmos-origindistribution/getdistributionvalidatorsbydelegatoraddress.md) - [GetDelegatorRewardsByDelegatorAddressValidatorAddress](https://docs.datafdn.org/api-reference/cosmos-origindistribution/getdelegatorrewardsbydelegatoraddressvalidatoraddress.md) - [GetDistributionValidatorByValidatorAddress](https://docs.datafdn.org/api-reference/cosmos-origindistribution/getdistributionvalidatorbyvalidatoraddress.md) - [GetValidatorCommissionByValidatorAddress](https://docs.datafdn.org/api-reference/cosmos-origindistribution/getvalidatorcommissionbyvalidatoraddress.md) - [GetValidatorOutstandingRewardsByValidatorAddress](https://docs.datafdn.org/api-reference/cosmos-origindistribution/getvalidatoroutstandingrewardsbyvalidatoraddress.md) - [GetValidatorSlashesByValidatorAddress](https://docs.datafdn.org/api-reference/cosmos-origindistribution/getvalidatorslashesbyvalidatoraddress.md) - [GetDelegatorRewardsByDelegatorAddress](https://docs.datafdn.org/api-reference/cosmos-origindistribution/getdelegatorrewardsbydelegatoraddress.md) - [GetMintParams](https://docs.datafdn.org/api-reference/cosmos-originmint/getmintparams.md) - [GetPeriodDelegationsByDelegatorAddress](https://docs.datafdn.org/api-reference/story-extendstaking/getperioddelegationsbydelegatoraddress.md) - [GetPeriodDelegationByDelegatorAddressAndID](https://docs.datafdn.org/api-reference/story-extendstaking/getperioddelegationbydelegatoraddressandid.md) - [Governance](https://docs.datafdn.org/foundation/governance.md): Learn about DATA Foundation's governance. - [DATA Foundation Disclaimer](https://docs.datafdn.org/foundation/disclaimer.md) - [MiCA White Paper](https://docs.datafdn.org/foundation/mica.md) - [Security Council](https://docs.datafdn.org/foundation/security-council.md) ## OpenAPI Specs - [openapi](https://api.dataapis.io/api/v4/openapi.json) - [consensus-client-api](https://docs.datafdn.org/api-reference/consensus-client/consensus-client-api.json) ## Optional - [Help & Support](https://discord.gg/databuilders) - [Network Status](https://status.datafdn.org) - [Explorer](https://www.datanetscan.io/)