Use this in browser apps after loading the hosted SDK. It avoids raw user lookup and pack-cards calls.

Aura.configure({ clientId: "your-app", readToken: "aura_pk_..." });

const session = Aura.getSession() || await Aura.signIn({ clientId: "your-app" });
const user = await Aura.getUser({ refresh: true });
const inventory = await Aura.getCurrentInventory({ limit: 200 });
const items = inventory.items || inventory.data;

console.log(session.walletAddress, user.username, items);

Use collection slugs or contract addresses; the SDK resolves pack ids and keeps pagination normalized.

const inventory = await Aura.getInventory({
  userAddress: "0xUSER...",
  collection: "aura-caps-test",
  limit: 200
});

const caps = inventory.items.filter((item) => item.type === "LOOT");
console.log(caps[0]?.collectionName, caps[0]?.attributes, caps[0]?.traitList);

Use SDK read helpers for pack detail, catalog, and offer state in browser apps.

const pack = await Aura.getPack("aura-caps-test");
const catalog = await Aura.getMarketplaceCatalog({ project: "auramaxxgg" });
const offers = await Aura.getMarketplaceOffers({ address: Aura.getWalletAddress() });

console.log(pack.pack?.name, catalog, offers);

Use this when a partner has a wallet or current session and wants profile, X, and Discord state without a custom /api/aura-profile route.

Aura.configure({ clientId: "aura-caps", readToken: "aura_pk_..." });

const session = Aura.getSession() || await Aura.signIn({ clientId: "aura-caps" });
const profile = await Aura.getUser({ refresh: true });
const byWallet = await Aura.getUser({ walletAddress: session.walletAddress });

console.log({
  username: profile.username || byWallet.username,
  wallet: session.walletAddress,
  x: profile.xConnected ? profile.xHandle : null,
  discord: profile.discordConnected
    ? profile.discordGlobalName || profile.discordUsername
    : null
});

Use this when a game needs owned items for one wallet and one collection, plus the collection/back image fields.

const inventory = await Aura.getInventory({
  userAddress: "0xUSER...",
  collection: "aura-caps-test",
  limit: 200
});

const items = inventory.items || inventory.data;
const first = items[0];

console.log({
  collectionName: first?.collectionName,
  collectionSlug: first?.collectionSlug,
  collectionImage: first?.collectionImage,
  packImage: first?.packImage,
  itemImage: first?.image
});

Use fields directly from condensed inventory rows; details is display copy, while traits and attributes are structured data.

const inventory = await Aura.getCurrentInventory({
  collection: "aura-caps-test",
  condensed: true,
  limit: 200
});

const cap = inventory.items.find((item) => item.type === "LOOT");
const traits = cap?.traitList || Object.entries(cap?.traits || {}).map(([trait_type, value]) => ({
  trait_type,
  value
}));

console.log({
  details: cap?.details,
  traits,
  rawAttributes: cap?.attributes,
  backArt: cap?.packImage || cap?.collectionImage
});