Core DAS API Extension

Summary

@metaplex-foundation/mpl-core-das is the DAS API extension for MPL Core. It returns Core-typed results (AssetV1, CollectionV1, GroupV1) instead of raw DAS shapes.

• Returns types ready for the MPL Core SDKs
• Automatically derives collection plugins on assets (optional to skip)
• Supports Core Groups, agent filters, and DAS-to-Core conversions
• Requires @metaplex-foundation/digital-asset-standard-api ≥ 2.1.0.

Install and setup: Getting Started.

Fetching

The Core DAS API Extension exposes typed fetch, list, and search helpers for Core assets, collections, and groups.

• getAsset: Fetch a single Core asset by public key.
• getCollection: Fetch a single Core collection by public key.
• getGroup: Fetch a single Core GroupV1 by public key.
• getAssetsByAuthority: List Core assets for an authority.
• getAssetsByCollection: List Core assets in a collection.
• getAssetsByOwner: List Core assets owned by a wallet.
• getAssetsByGroup: List members of an mpl-core GroupV1 (groupKey: "group").
• getGrouping: Return group name and indexed size without listing members.
• searchAssets: Search Core assets (includes agent filters).
• searchCollections: Search Core collections (includes by update authority).
• searchGroups: Search Core groups (includes by update authority).

Type Conversion

Conversion helpers map raw DAS items into Core SDK types when you mix standards in one query.

• dasAssetsToCoreAssets: Convert DAS items to Core assets
• dasAssetToCoreCollection: Convert a DAS item to a Core collection
• dasAssetToCoreGroup: Convert a DAS item to a Core group

Plugin Derivations

This library automatically derives plugins that assets inherit from their collection. Read more about plugin inheritance and precedence on the Core plugins page.

To disable derivation or implement it manually, see Plugin Derivation.

Notes

Core DAS helpers prefer indexed reads over GPA and may omit some on-chain group membership fields depending on the indexer.

• Prefer this package over GPA helpers (fetchAssetsByOwner / fetchAssetsByCollection) for production listing.
• GroupResult membership vectors (collections, groups, parentGroups, assets) may be empty from DAS — use fetchGroupV1 for authoritative on-chain membership.
• Agent discovery uses searchAssets({ isAgent: true }) and may populate is_agent, agent_token, and asset_signer on results when indexed.

Quick Reference

Glossary