Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.
JavaScript 3d-generationai-agentsanimationavatardigital-humangenerative-aiglbgltfimage-to-3dllmmcpmcp-servermodel-context-protocolsolanatext-to-3dthreejsweb-componentswebglwebxrx402
import { fetchOwnedNFTs, ownsCollection, fetchSolanaPurchasedAssets } from "./mint-utils";
import { getAsArray } from "./utils";
import { OwnedNFTTraitIDs } from "./ownedNFTTraitIDs";
import { connectWallet } from "./mint-utils";
/**
* Handles wallet operations and NFT collection interactions.
*/
export class WalletCollections {
/**
* Creates an instance of the WalletCollections class.
*/
constructor() {}
/**
* Checks if a wallet purchased assets from specific collection
*
* @param {Object} solanaPurchaseAssetsDefinition - Solanas purchase assets definition.
* @param {string|null} testWallet - The wallet address to use, or `null` to use the active wallet.
* @returns {Promise<Object>} A promise resolving to an object containing owned assets
*/
getSolanaPurchasedAssets(solanaPurchaseAssetsDefinition, testWallet){
console.log(solanaPurchaseAssetsDefinition);
const {
delegateAddress,
collectionName
} = solanaPurchaseAssetsDefinition;
const walletPromise = testWallet
? Promise.resolve(testWallet)
: connectWallet("solana");
return new Promise((resolve)=>{
walletPromise
.then(wallet => fetchSolanaPurchasedAssets(wallet, delegateAddress, collectionName).then(response=>{
resolve(new OwnedNFTTraitIDs({ownedIDs:response.ownedIDs,ownedTraits:response.ownedTraits}));
}))
.catch(()=>{
resolve(null);
})
});
}
/**
* Checks if a wallet owns a specific NFT collection.
*
* @param {string} collectionName - The name of the NFT collection.
* @param {string} chainName - The blockchain name (`"ethereum"`, `"polygon"` or `"solana"`).
* @param {string|null} testWallet - The wallet address to use, or `null` to use the active wallet.
* @returns {Promise<boolean>} A promise resolving to `true` if the wallet owns the collection, otherwise `false`.
*/
checkForOwnership(collectionName, chainName, testWallet) {
const walletPromise = testWallet
? Promise.resolve(testWallet)
: connectWallet(chainName);
return walletPromise.then(wallet => ownsCollection(wallet, chainName, collectionName));
}
/**
* Retrieves NFTs from a specific collection owned by a wallet.
*
* @param {string} collectionName - The name of the NFT collection.
* @param {string} chainName - The blockchain name (`"ethereum"`, `"polygon"` or `"solana"`).
* @param {string|null} testWallet - The wallet address to use, or `null` to use the active wallet.
* @returns {Promise<Array<Object>>} A promise resolving to an array of NFT objects.
*/
getNftsFromCollection(collectionName, chainName, testWallet) {
const walletPromise = testWallet
? Promise.resolve(testWallet)
: connectWallet(chainName);
return walletPromise
.then(wallet => fetchOwnedNFTs(wallet, chainName, collectionName))
.then(collection => getAsArray(collection?.nfts));
}
/**
* Retrieves metadata for NFTs in a specific collection.
*
* @param {string} collectionName - The name of the NFT collection.
* @param {string} chainName - The blockchain name (`"ethereum"` or `"polygon"`).
* @param {string|null} testWallet - The wallet address to use, or `null` to use the active wallet.
* @returns {Promise<Array<Object>>} A promise resolving to an array of metadata objects.
*/
getMetaFromCollection(collectionName, chainName, testWallet) {
return this.getNftsFromCollection(collectionName, chainName, testWallet)
.then(ownedNfts => {
console.log(ownedNfts);
const getNftsMeta = nfts => {
const nftsMeta = [];
const promises = nfts.map(nft =>
new Promise(resolve => {
console.log(nft);
fetch(nft.metadata_url)
.then(response => response.json())
.then(metadata => {
nftsMeta.push(metadata);
resolve();
})
.catch(err => {
console.warn("Error processing metadata:", nft.metadata_url);
console.error(err);
resolve(); // Resolve even on failure to avoid halting
});
})
);
return Promise.all(promises).then(() => nftsMeta);
};
return getNftsMeta(ownedNfts);
});
}
/**
* Retrieves traits or IDs from NFTs in a specific collection.
*
* @param {string} collectionName - The name of the NFT collection.
* @param {string} chainName - The blockchain name (`"ethereum"` or `"polygon"`).
* @param {string} dataSource - The source of the data (`"attributes"` or `"image"`).
* @param {string|null} testWallet - The wallet address to use, or `null` to use the active wallet.
* @returns {Promise<OwnedTraitIDs>} A promise resolving to an OwnedNFTTraitIDs object.
*/
getTraitsFromCollection(collectionName, chainName, dataSource, testWallet) {
if (collectionName == null || chainName == null || dataSource == null){
console.error("Missing parameter: collectionName, chainName or dataSource to fetch nft collection, skipping nft validation")
return Promise.resolve({});
}
console.log("gets");
if (dataSource == "name"){
return this.getNftsFromCollection(collectionName, chainName, testWallet)
.then(nfts=> {console.log(nfts); return new OwnedNFTTraitIDs(nfts, dataSource)});
}
else{
return this.getMetaFromCollection(collectionName, chainName, testWallet)
.then(nftMeta => new OwnedNFTTraitIDs(nftMeta, dataSource));
}
}
}