Result Types

TypeScript result types for MagenX404

X404AuthResult

All authentication features return an X404AuthResult:

interface X404AuthResult {
  success: boolean;
  alreadyAuthenticated?: boolean;
  token?: string;
  data?: unknown;
  error?:
    | "NONCE_ERROR"
    | "SIGNING_ERROR"
    | "LOCATION_ERROR"
    | "LOCATION_DENIED"
    | "HOLDS_BANNED_TOKEN"
    | "EXCEEDS_MAX_HOLDING"
    | "INSUFFICIENT_HOLD_DURATION"
    | "INSUFFICIENT_TOKENS"
    | "INSUFFICIENT_ACTIVITY"
    | "HAS_DEBT"
    | "WALLET_TOO_NEW"
    | "WALLET_CANCELLED"
    | "UNKNOWN_ERROR";
  message?: string;
  tier?: "bronze" | "silver" | "gold";
}

Field Descriptions

success · boolean · required

Whether authentication was successful

alreadyAuthenticated · boolean

Whether user was already authenticated (token exists in localStorage)

token · string

JWT token (if successful). Automatically stored in localStorage

data · unknown

Additional data returned from the server

error · string

Error type if authentication failed

message · string

Human-readable error message

tier · 'bronze' | 'silver' | 'gold'

User’s tier (only for X404Tier feature)

Success Example

{
  success: true,
  token: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  alreadyAuthenticated: false
}

Error Example

{
  success: false,
  error: "HOLDS_BANNED_TOKEN",
  message: "Wallet holds excluded token: token_address"
}

Usage

import { X404Blacklist } from "magenx404";

const result = await X404Blacklist({
  excluded_mints: ["token_address"],
  max_holdings: {},
  geo_code: "false",
  geo_code_locs: "",
  coords: { latitude: null, longitude: null },
});

if (result.success) {
  console.log("Token:", result.token);
} else {
  console.error("Error:", result.error, result.message);
}

Error Types

All authentication functions can return the following error types:

Token Storage

Each feature automatically stores its JWT token in localStorage with the following keys:

• sjwt404_timelock - Timelock feature
• sjwt404_blacklist - Blacklist feature
• sjwt404_multitoken - MultiToken feature
• sjwt404_activity - Activity feature
• sjwt404_tier - Tier feature
• sjwt404_nodebt - NoDebt feature
• sjwt404_age - Age feature

Tokens persist across sessions and are automatically checked on subsequent authentication attempts.