Skip to main content
⚠️ Legacy SDK DocumentationThis documentation uses our older SDK (@handcash/handcash-connect), but the v3 SDK does not support this feature yet.

Collection Management

This guide demonstrates how to create and manage collections using the HandCash Connect SDK. Collections are used to organize your digital items.

Setup

Create a Collection

To create a collection, use the createCollectionOrder method:

Collection Order Response

Get Collection Details

Retrieve details of an existing collection:

Strategy

  • Create a single top-level collection for your app to keep things organized
  • Use item attributes to categorize sub-types (rarity, season, set, etc.) within your collection
  • Keep immutable metadata minimal and reference off-chain metadata via URLs for flexibility
  • Save your collection ID after creation - you’ll need it when creating items

Best Practices

  1. Create your collection once during app initialization and store the collection ID
  2. Use descriptive names and descriptions for your collections
  3. Provide high-quality images for your collection media
  4. Use item attributes to organize items within a collection rather than creating multiple collections