Contracts, Contacts, Assets & Wallet
Needs an access tokenDemonstrates character contract bids/items, corporation contracts, alliance/corporation contacts, corporation assets, corporation wallets (journal + transactions), and public structure lookup.
Most corporation endpoints require director roles and will gracefully skip with a message if the token lacks permission.
REQUIRES AUTHENTICATION — set ESI_ACCESS_TOKEN in your environment.
Calls: contracts.getCharacterContracts · contracts.getCharacterContractBids · contracts.getCharacterContractItems · contracts.getCorporationContracts · contracts.getCorporationContractBids · contracts.getCorporationContractItems · contacts.getAllianceContacts · contacts.getAllianceContactLabels · contacts.getCorporationContacts · contacts.getCorporationContactLabels · assets.getCorporationAssets · wallet.getCorporationWallets · wallet.getCorporationWalletJournal · wallet.getCorporationWalletTransactions · universe.getStructures · universe.getStructureById
Run it
bash
git clone https://github.com/lgriffin/ESI.ts.git && cd ESI.ts
npm ci
npm run example:corp-contracts-walletexamples/corp-contracts-wallet.ts on GitHub. The imports below are written as a consumer of the package writes them; the file in the repository imports from ../src.
Source
ts
import { EsiClient } from '@lgriffin/esi.ts';
import { EsiError } from '@lgriffin/esi.ts/errors';
import { createConsoleLogger } from '@lgriffin/esi.ts';
// The program's own output. The client logs through the same console sink
// at ESI_LOG_LEVEL (default warn), so its diagnostics stay out of the way.
const log = createConsoleLogger('info');
const esiLog = createConsoleLogger();
const CHARACTER_ID = 90439768;
const CORP_ID = 98135622;
const ALLIANCE_ID = 99000001;
async function tryOrSkip(
label: string,
fn: () => Promise<void>,
): Promise<void> {
try {
await fn();
} catch (err) {
if (
err instanceof EsiError &&
(err.statusCode === 403 || err.statusCode === 401)
) {
log.info(` ${label}: requires corporation/alliance roles — skipped`);
} else {
throw err;
}
}
}
async function main() {
const client = new EsiClient({ logger: esiLog });
try {
log.info('Contracts, Contacts, Assets & Wallet\n');
// --- Character Contract Bids & Items ---
log.info('Character Contract Bids & Items');
log.info('-'.repeat(50));
const charContracts =
await client.contracts.getCharacterContracts(CHARACTER_ID);
log.info(` Character contracts: ${charContracts.length}`);
if (charContracts.length > 0) {
const first = charContracts[0]!;
log.info(
` First contract: ${first.contract_id} (${first.type}, ${first.status})`,
);
try {
const bids = await client.contracts.getCharacterContractBids(
CHARACTER_ID,
first.contract_id,
);
log.info(` Bids: ${bids.length}`);
} catch (err) {
if (err instanceof EsiError && err.statusCode === 404) {
log.info(' Bids: N/A (not an auction)');
} else {
throw err;
}
}
try {
const items = await client.contracts.getCharacterContractItems(
CHARACTER_ID,
first.contract_id,
);
log.info(` Items: ${items.length}`);
} catch (err) {
if (err instanceof EsiError && err.statusCode === 404) {
log.info(' Items: N/A');
} else {
throw err;
}
}
} else {
log.info(' No contracts found');
}
// --- Corporation Contracts ---
log.info('\nCorporation Contracts');
log.info('-'.repeat(50));
await tryOrSkip('Corp contracts', async () => {
const corpContracts =
await client.contracts.getCorporationContracts(CORP_ID);
log.info(` Corporation contracts: ${corpContracts.length}`);
if (corpContracts.length > 0) {
const first = corpContracts[0]!;
log.info(
` First: ${first.contract_id} (${first.type}, ${first.status})`,
);
try {
const bids = await client.contracts.getCorporationContractBids(
CORP_ID,
first.contract_id,
);
log.info(` Bids: ${bids.length}`);
} catch (err) {
if (err instanceof EsiError && err.statusCode === 404) {
log.info(' Bids: N/A (not an auction)');
} else {
throw err;
}
}
try {
const items = await client.contracts.getCorporationContractItems(
CORP_ID,
first.contract_id,
);
log.info(` Items: ${items.length}`);
} catch (err) {
if (err instanceof EsiError && err.statusCode === 404) {
log.info(' Items: N/A');
} else {
throw err;
}
}
}
});
// --- Alliance Contacts ---
log.info('\nAlliance Contacts');
log.info('-'.repeat(50));
await tryOrSkip('Alliance contacts', async () => {
const contacts = await client.contacts.getAllianceContacts(ALLIANCE_ID);
log.info(` Alliance contacts: ${contacts.length}`);
});
await tryOrSkip('Alliance contact labels', async () => {
const labels =
await client.contacts.getAllianceContactLabels(ALLIANCE_ID);
log.info(` Alliance contact labels: ${labels.length}`);
});
// --- Corporation Contacts ---
log.info('\nCorporation Contacts');
log.info('-'.repeat(50));
await tryOrSkip('Corp contacts', async () => {
const contacts = await client.contacts.getCorporationContacts(CORP_ID);
log.info(` Corporation contacts: ${contacts.length}`);
});
await tryOrSkip('Corp contact labels', async () => {
const labels = await client.contacts.getCorporationContactLabels(CORP_ID);
log.info(` Corporation contact labels: ${labels.length}`);
});
// --- Corporation Assets ---
log.info('\nCorporation Assets');
log.info('-'.repeat(50));
await tryOrSkip('Corp assets', async () => {
const assets = await client.assets.getCorporationAssets(CORP_ID);
log.info(` Corporation assets: ${assets.length}`);
for (const a of assets.slice(0, 5)) {
log.info(
` Type ${a.type_id}: qty ${a.quantity} in ${a.location_type} ${a.location_id}`,
);
}
if (assets.length > 5) log.info(` ... and ${assets.length - 5} more`);
});
// --- Corporation Wallets ---
log.info('\nCorporation Wallets');
log.info('-'.repeat(50));
await tryOrSkip('Corp wallets', async () => {
const wallets = await client.wallet.getCorporationWallets(CORP_ID);
log.info(` Wallet divisions: ${wallets.length}`);
for (const w of wallets) {
log.info(
` Division ${w.division}: ${w.balance.toLocaleString()} ISK`,
);
}
if (wallets.length > 0) {
const div = wallets[0]!.division;
const journal = await client.wallet.getCorporationWalletJournal(
CORP_ID,
div,
);
log.info(`\n Division ${div} journal entries: ${journal.length}`);
for (const entry of journal.slice(0, 3)) {
log.info(
` ${entry.date}: ${entry.ref_type} — ${entry.amount?.toLocaleString() ?? 0} ISK`,
);
}
if (journal.length > 3)
log.info(` ... and ${journal.length - 3} more`);
const txns = await client.wallet.getCorporationWalletTransactions(
CORP_ID,
div,
);
log.info(`\n Division ${div} transactions: ${txns.length}`);
for (const tx of txns.slice(0, 3)) {
log.info(
` ${tx.date}: type ${tx.type_id} x${tx.quantity} @ ${tx.unit_price.toLocaleString()} ISK`,
);
}
if (txns.length > 3) log.info(` ... and ${txns.length - 3} more`);
}
});
// --- Structures (public list + detail) ---
log.info('\nPublic Structures');
log.info('-'.repeat(50));
try {
const structureIds = await client.universe.getStructures();
log.info(` Public structure IDs: ${structureIds.length}`);
if (structureIds.length > 0) {
try {
const detail = await client.universe.getStructureById(
structureIds[0]!,
);
log.info(` Structure ${structureIds[0]}: ${detail.name}`);
log.info(
` System: ${detail.solar_system_id}, Type: ${detail.type_id ?? 'N/A'}`,
);
} catch (err) {
if (
err instanceof EsiError &&
(err.statusCode === 403 || err.statusCode === 401)
) {
log.info(' Structure detail requires docking access — skipped');
} else {
throw err;
}
}
}
} catch (err) {
if (
err instanceof EsiError &&
(err.statusCode === 403 || err.statusCode === 401)
) {
log.info(' Requires authentication — skipped');
} else {
throw err;
}
}
} catch (err) {
if (
err instanceof EsiError &&
(err.statusCode === 401 || err.statusCode === 403)
) {
log.error('Authentication required. Set ESI_ACCESS_TOKEN.');
} else {
log.error('Request failed', { error: err });
}
process.exit(1);
} finally {
await client.shutdown();
}
}
main();