wallet-core/src/loginWithAuraSdk.ts
Sign In With Aura
Add a Login with Aura button, open the hosted iframe join flow, and receive the user wallet for read-only app state.
START HERE
Sign In With Aura
What This Gives You
Current Scope
- A hosted `Aura.SigninButton` and React-friendly `Aura.SigninWithAura` button that open the Aura join flow in an iframe.
- A read-only login result with the Aura user id, username, display name, avatar, and wallet address.
- Read-only SDK helpers for public user, inventory, pack, and marketplace data.
- No bearer token export and no write permission. Use the delegated-user developer lane when you need writes later.
Browser Install
Live Example
Light Mode
Dark Mode
Loading SDK
Production
<div id="aura-login"></div>
<script src="https://auramaxx.gg/login-with-aura/sdk.js" data-aura-origin="https://auramaxx.gg"></script>
<script>
Aura.SigninButton({
container: "#aura-login",
clientId: "your-app",
onSuccess(result) {
console.log(result.walletAddress);
console.log(result.user);
}
});
</script>React Button
const { SigninWithAura } = Aura;
function LoginPanel() {
return (
<SigninWithAura
mode="light"
clientId="your-app"
onSuccess={async (session) => {
const user = await Aura.getUser();
const inventory = await Aura.getInventory({ limit: 200 });
console.log(session.walletAddress, user, inventory);
}}
/>
);
}Full SDK API
For every hosted SDK method, alias, and read helper, use /api/sdk-api.
Result Shape
Read-Only Payload
{
"authenticated": true,
"clientId": "your-app",
"walletAddress": "0xUSER...",
"user": {
"id": "user-id",
"username": "aura-user",
"displayName": "Aura User",
"avatar": null,
"address": "0xUSER...",
"addresses": ["0xUSER..."],
"verifiedExternalAddresses": []
}
}Optional Direct Promise API
const result = await Aura.signIn({
auraOrigin: "https://auramaxx.gg",
clientId: "your-app"
});
const walletAddress = result.walletAddress;Read Helpers
const session = await Aura.signIn({
clientId: "your-app",
mode: "light"
});
const user = await Aura.getUser();
const inventory = await Aura.getInventory({ limit: 200 });
const created = await Aura.getCreatedPacks({ limit: 12 });
const capabilities = await Aura.getDeveloperCapabilities();
const catalog = await Aura.getMarketplaceCatalog({ project: "auramaxxgg" });
const offers = await Aura.getMarketplaceOffers({
address: session.walletAddress
});
const v2Offers = await Aura.getMarketplaceV2Offers({
address: session.walletAddress
});Agent Notes
Bare Minimum
- Load
https://auramaxx.gg/login-with-aura/sdk.jsin the browser app. - Render
Aura.SigninButtoninto a DOM container, or use<SigninWithAura mode="light" />when React is already loaded. - Treat
result.walletAddressas the read-only wallet identity for public profile, inventory, and marketplace reads. - Use
Aura.getUser,Aura.getInventory,Aura.getCreatedPacks,Aura.getDeveloperCapabilities, and marketplace read helpers before reaching for auth. - Use the full SDK API reference when choosing a read helper or React/DOM button surface.
- Do not ask for or store an Aura session token from this iframe flow.
Write Actions
Sign in with Aura is read-only today. For create, buy, sell, offer, transfer, or mint flows, switch to the delegated-user developer lane and use a user-approved access key bundle.
Document Reference
wallet-core/src/loginWithAuraSdk.ts
