emblem-vault-sdk 2.3.6 → 3.0.0-experimental

package/test/mocks.js

@@ -0,0 +1,127 @@
+/**
+ * Mock data for Emblem Vault SDK tests
+ */
+
+// Empty vault creation template
+const empty_create_template = {
+  contractName: 'Emblem Open',
+  name: 'Test Vault',
+  description: 'Test vault created by automated tests',
+  image: 'https://emblem.finance/stamps.png',
+  fromAddress: '', // Will be populated in tests
+  toAddress: '',   // Will be populated in tests
+  chainId: '1',    // Ethereum mainnet
+  targetContract: {} // Empty object to prevent null reference errors
+};
+
+// Emblem Open vault creation template with more details
+const emblemopen_create_template = {
+  contractName: 'Emblem Open',
+  name: 'Test Vault with Asset',
+  description: 'Test vault with asset created by automated tests',
+  image: 'https://emblem.finance/stamps.png',
+  fromAddress: '', // Will be populated in tests
+  toAddress: '',   // Will be populated in tests
+  chainId: '1',    // Ethereum mainnet
+  targetContract: {}, // Empty object to prevent null reference errors
+  targetAsset: {
+    name: '',      // Will be populated in tests
+    image: '',     // Will be populated in tests
+    description: '' // Will be populated in tests
+  }
+};
+
+// Mock data for API operations tests
+const ethscription_contract = {
+  name: 'Ethscription',
+  mintable: true,
+  description: 'Ethscriptions are digital artifacts inscribed to Ethereum',
+  image: 'https://emblem.finance/ethscriptions.png',
+  contractAddress: '0x1234567890123456789012345678901234567890'
+};
+
+const curated_contracts = [
+  {
+    name: 'Emblem Open',
+    mintable: true,
+    description: 'Open template for creating vaults',
+    image: 'https://emblem.finance/emblemopen.png',
+    contractAddress: '0x0987654321098765432109876543210987654321'
+  },
+  ethscription_contract,
+  {
+    name: 'Bitcoin Ordinals',
+    mintable: true,
+    description: 'Bitcoin Ordinals template',
+    image: 'https://emblem.finance/ordinals.png',
+    contractAddress: '0xabcdef1234567890abcdef1234567890abcdef12'
+  }
+];
+
+const sample_vaults = [
+  {
+    tokenId: '12345',
+    name: 'Test Vault 1',
+    description: 'A test vault for integration tests',
+    image: 'https://emblem.finance/testvault1.png',
+    owner: '0xb0573e14D92755DE30281f7b10d0F3a5DD3e747B',
+    contractAddress: '0x0987654321098765432109876543210987654321',
+    chainId: '1'
+  },
+  {
+    tokenId: '67890',
+    name: 'Test Vault 2',
+    description: 'Another test vault for integration tests',
+    image: 'https://emblem.finance/testvault2.png',
+    owner: '0xb0573e14D92755DE30281f7b10d0F3a5DD3e747B',
+    contractAddress: '0x0987654321098765432109876543210987654321',
+    chainId: '1'
+  }
+];
+
+const bitcoin_ordinals_metadata = [
+  {
+    projectName: 'Bitcoin Ordinals',
+    description: 'Bitcoin Ordinals are digital artifacts on the Bitcoin blockchain',
+    image: 'https://emblem.finance/ordinals.png',
+    assetId: 'btc-ordinals',
+    contractAddress: '0xabcdef1234567890abcdef1234567890abcdef12'
+  }
+];
+
+const project_list = [
+  {
+    name: 'Bitcoin Ordinals',
+    description: 'Bitcoin Ordinals are digital artifacts on the Bitcoin blockchain',
+    image: 'https://emblem.finance/ordinals.png'
+  },
+  {
+    name: 'Ethscriptions',
+    description: 'Ethscriptions are digital artifacts inscribed to Ethereum',
+    image: 'https://emblem.finance/ethscriptions.png'
+  }
+];
+
+const created_vault_response = {
+  data: {
+    tokenId: '123456789',
+    name: 'Test Vault',
+    description: 'Test vault created by automated tests',
+    image: 'https://emblem.finance/stamps.png',
+    owner: '0xb0573e14D92755DE30281f7b10d0F3a5DD3e747B',
+    contractAddress: '0x0987654321098765432109876543210987654321',
+    chainId: '1',
+    status: 'created'
+  }
+};
+
+module.exports = {
+  empty_create_template,
+  emblemopen_create_template,
+  ethscription_contract,
+  curated_contracts,
+  sample_vaults,
+  bitcoin_ordinals_metadata,
+  project_list,
+  created_vault_response
+};

package/test/tsconfig.json

@@ -0,0 +1,25 @@
+{
+  "extends": "../tsconfig.json",
+  "compilerOptions": {
+    "target": "es2018",
+    "module": "commonjs",
+    "esModuleInterop": true,
+    "resolveJsonModule": true,
+    "outDir": "../dist-test",
+    "rootDir": "./",
+    "strict": false,
+    "declaration": false,
+    "sourceMap": true,
+    "baseUrl": "..",
+    "paths": {
+      "*": ["*"]
+    }
+  },
+  "include": [
+    "**/*.ts",
+    "**/*.json"
+  ],
+  "references": [
+    { "path": ".." }
+  ]
+}

package/test/unit/AllowedBells.spec.js

@@ -0,0 +1,53 @@
+const { EmblemVaultSDK } = require('../../dist/index.js');
+const { expect } = require('chai');
+const fs = require('fs');
+const path = require('path');
+
+describe('Allowed Function for Bells', () => {
+    const sdk = new EmblemVaultSDK('DEMO_KEY');
+
+    it('Does not allow empty balance', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('Bells');
+        expect(curatedContract.allowed(null, curatedContract)).to.be.false;
+        expect(curatedContract.allowed([], curatedContract)).to.be.false;
+    });
+
+    it('Requires balance to be greater than zero', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('Bells');
+        const balanceValues = JSON.parse(fs.readFileSync(path.join(__dirname, "../fixtures/bells/balance.json")));
+        balanceValues[0].balance = 0;
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.false;
+    });
+
+    it('Requires balance to be an integer', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('Bells');
+        const balanceValues = JSON.parse(fs.readFileSync(path.join(__dirname, "../fixtures/bells/balance.json")));
+        balanceValues[0].balance = 1.5;
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.false;
+    });
+
+    it('Requires name to be `Bel`', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('Bells');
+        const balanceValues = JSON.parse(fs.readFileSync(path.join(__dirname, "../fixtures/bells/balance.json")));
+        balanceValues[0].name = 'invalid name';
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.false;
+    });
+
+    it('Does not allow non-bel assets as first value', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('Bells');
+        const balanceValues = JSON.parse(fs.readFileSync(path.join(__dirname, "../fixtures/bells/balance-with-non-bell-first.json")));
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.false;
+    });
+
+    it('Allows non-bel assets if not first', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('Bells');
+        const balanceValues = JSON.parse(fs.readFileSync(path.join(__dirname, "../fixtures/bells/balance-with-non-bell.json")));
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.true;
+    });
+
+    it('Allows valid balances', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('Bells');
+        const balanceValues = JSON.parse(fs.readFileSync(path.join(__dirname, "../fixtures/bells/balance.json")));
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.true;
+    });
+});

package/test/unit/AllowedBitcoinDeGods.spec.js

@@ -0,0 +1,53 @@
+const { EmblemVaultSDK } = require('../../dist/index.js');
+const { expect } = require('chai');
+const fs = require('fs');
+const path = require('path');
+
+describe('Allowed Function for Bitcoin DeGods', () => {
+    const sdk = new EmblemVaultSDK('DEMO_KEY');
+
+    it('Does not allow empty balance', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('Bitcoin DeGods');
+        expect(curatedContract.allowed(null, curatedContract)).to.be.false;
+        expect(curatedContract.allowed([], curatedContract)).to.be.false;
+    });
+
+    it('Requires coin to be ordinalsbtc', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('Bitcoin DeGods');
+        const balanceValues = JSON.parse(fs.readFileSync(path.join(__dirname, "../fixtures/bitcoin-degods/balance.json")));
+        balanceValues[0].coin = 'invalid value';
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.false;
+    });
+
+    it('Requires balance to be 1', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('Bitcoin DeGods');
+        const balanceValues = JSON.parse(fs.readFileSync(path.join(__dirname, "../fixtures/bitcoin-degods/balance.json")));
+        balanceValues[0].balance = 2;
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.false;
+    });
+
+    it('Requires project to be DeGods', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('Bitcoin DeGods');
+        const balanceValues = JSON.parse(fs.readFileSync(path.join(__dirname, "../fixtures/bitcoin-degods/balance.json")));
+        balanceValues[0].project = 'invalid project';
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.false;
+    });
+
+    it('Does not allow non-ordinalsbtc as first coin', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('Bitcoin DeGods');
+        const balanceValues = JSON.parse(fs.readFileSync(path.join(__dirname, "../fixtures/bitcoin-degods/balance-with-non-degods-first.json")));
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.false;
+    });
+
+    it('Allows non-ordinalsbtc if not first coin', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('Bitcoin DeGods');
+        const balanceValues = JSON.parse(fs.readFileSync(path.join(__dirname, "../fixtures/bitcoin-degods/balance-with-non-degods.json")));
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.true;
+    });
+
+    it('Allows valid balances', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('Bitcoin DeGods');
+        const balanceValues = JSON.parse(fs.readFileSync(path.join(__dirname, "../fixtures/bitcoin-degods/balance.json")));
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.true;
+    });
+});

package/test/unit/AllowedBitcoinOrdinals.spec.js

@@ -0,0 +1,46 @@
+const { EmblemVaultSDK } = require('../../dist/index.js');
+const { expect } = require('chai');
+const fs = require('fs');
+const path = require('path');
+
+describe('Allowed Function for BitcoinOrdinals', () => {
+    const sdk = new EmblemVaultSDK('DEMO_KEY');
+
+    it('Does not allow empty balance', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('BitcoinOrdinals');
+        expect(curatedContract.allowed(null, curatedContract)).to.be.false;
+        expect(curatedContract.allowed([], curatedContract)).to.be.false;
+    });
+
+    it('Allows native balance as first value', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('BitcoinOrdinals');
+        const balanceValues = JSON.parse(fs.readFileSync(path.join(__dirname, "../fixtures/bitcoin-ordinals/balance-with-native-first.json")));
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.true;
+    });
+
+    it('Does not allow only native balances', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('BitcoinOrdinals');
+        const balanceValues = JSON.parse(fs.readFileSync(path.join(__dirname, "../fixtures/bitcoin-ordinals/balance-with-only-native.json")));
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.false;
+    });
+
+    it('Requires first non-native balance to be a bitcoin ordinal', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('BitcoinOrdinals');
+        const balanceValues = JSON.parse(fs.readFileSync(path.join(__dirname, "../fixtures/cursed-ordinals/balance-with-native-first.json")));
+        balanceValues[1].coin = 'invalid coin';
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.false;
+    });
+
+    it('Does not allow incorrect coin', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('BitcoinOrdinals');
+        const balanceValues = JSON.parse(fs.readFileSync(path.join(__dirname, "../fixtures/bitcoin-ordinals/balance.json")));
+        balanceValues[0].coin = "invalid coin";
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.false;
+    });
+
+    it('Allows valid balances', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('BitcoinOrdinals');
+        const balanceValues = JSON.parse(fs.readFileSync(path.join(__dirname, "../fixtures/bitcoin-ordinals/balance.json")));
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.true;
+    });
+});

package/test/unit/AllowedCounterparty.spec.js

@@ -0,0 +1,66 @@
+/**
+ * Counterparty Collection Tests
+ * Tests for the Counterparty collection's allowed function
+ */
+
+const { EmblemVaultSDK } = require('../../dist/index');
+const fs = require('fs');
+const path = require('path');
+const { expect } = require('chai');
+
+// Test constants
+const API_KEY = 'DEMO_KEY';
+
+describe('Allowed Function for Counterparty', function() {
+  // Increase timeout for API calls
+  this.timeout(10000);
+  
+  const sdk = new EmblemVaultSDK(API_KEY);
+  
+  // Helper function to get fixture path
+  const getFixturePath = (filename) => {
+    return path.join(__dirname, '../fixtures/counterparty', filename);
+  };
+
+  it('Does not allow empty balance', async () => {
+    const curatedContract = await sdk.fetchCuratedContractByName('Counterparty');
+    expect(curatedContract.allowed(null, curatedContract)).to.be.false;
+    expect(curatedContract.allowed([], curatedContract)).to.be.false;
+  });
+
+  it('Does not allow more than one asset', async () => {
+    const curatedContract = await sdk.fetchCuratedContractByName('Counterparty');
+    const balanceValues = JSON.parse(fs.readFileSync(getFixturePath("balance-with-multiple.json"), 'utf8'));
+    balanceValues[0].coin = 'invalid coin';
+    expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.false;
+  });
+
+  it('Does not allow non-native coin', async () => {
+    const curatedContract = await sdk.fetchCuratedContractByName('Counterparty');
+    const balanceValues = JSON.parse(fs.readFileSync(getFixturePath("balance.json"), 'utf8'));
+    balanceValues[0].coin = 'invalid coin';
+    expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.false;
+  });
+
+  it('Allows collection chain asset', async () => {
+    const curatedContract = await sdk.fetchCuratedContractByName('Counterparty');
+    const balanceValues = JSON.parse(fs.readFileSync(getFixturePath("balance.json"), 'utf8'));
+    
+    // For protocol collections, only the collectionChain asset is allowed
+    balanceValues[0].coin = curatedContract.collectionChain;
+    expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.true;
+    
+    // Test case insensitivity
+    balanceValues[0].coin = curatedContract.collectionChain.toUpperCase();
+    expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.true;
+  });
+
+  it('Allows valid balance', async () => {
+    const curatedContract = await sdk.fetchCuratedContractByName('Counterparty');
+    const balanceValues = JSON.parse(fs.readFileSync(getFixturePath("balance.json"), 'utf8'));
+    
+    // Make sure the coin matches the collectionChain for protocol collections
+    balanceValues[0].coin = curatedContract.collectionChain;
+    expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.true;
+  });
+});

package/test/unit/AllowedCursedOrdinals.spec.js

@@ -0,0 +1,68 @@
+const { EmblemVaultSDK } = require('../../dist/index.js');
+const { expect } = require('chai');
+const fs = require('fs');
+const path = require('path');
+
+describe('Allowed Function for Cursed Ordinals', () => {
+    const sdk = new EmblemVaultSDK('DEMO_KEY');
+
+    it('Does not allow empty balance', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('Cursed Ordinal');
+        expect(curatedContract.allowed(null, curatedContract)).to.be.false;
+        expect(curatedContract.allowed([], curatedContract)).to.be.false;
+    });
+
+    it('Does not allow application/json content type', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('Cursed Ordinal');
+        const balanceValues = JSON.parse(fs.readFileSync(path.join(__dirname, "../fixtures/cursed-ordinals/balance.json")));
+        balanceValues[0].content_type = 'application/json';
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.false;
+    });
+
+    it('Does not allow incorrect coin', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('Cursed Ordinal');
+        const balanceValues = JSON.parse(fs.readFileSync(path.join(__dirname, "../fixtures/cursed-ordinals/balance.json")));
+        balanceValues[0].coin = "invalid coin";
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.false;
+    });
+
+    it('Does not allow incorrect names', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('Cursed Ordinal');
+        const balanceValues = JSON.parse(fs.readFileSync(path.join(__dirname, "../fixtures/cursed-ordinals/balance.json")));
+        balanceValues[0].name = "Invalid Name";
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.false;
+
+        balanceValues[0].name = "Cursed Ordinal";
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.false;
+
+        balanceValues[0].name = "Cursed Ordinal InvalidNumber";
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.false;
+
+        balanceValues[0].name = "Cursed Ordinal 53888";
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.false;
+
+        balanceValues[0].name = "Invalid Project -53888";
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.false;
+
+        balanceValues[0].name = "Cursed Ordinal -53888";
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.true;
+    });
+
+    it('Requires first balance value to be a cursed ordinal', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('Cursed Ordinal');
+        const balanceValues = JSON.parse(fs.readFileSync(path.join(__dirname, "../fixtures/cursed-ordinals/balance-with-native-first.json")));
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.false;
+    });
+
+    it('Allows non-cursed ordinal balances if not first', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('Cursed Ordinal');
+        const balanceValues = JSON.parse(fs.readFileSync(path.join(__dirname, "../fixtures/cursed-ordinals/balance-with-native.json")));
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.true;
+    });
+
+    it('Allows valid coin and name', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('Cursed Ordinal');
+        const balanceValues = JSON.parse(fs.readFileSync(path.join(__dirname, "../fixtures/cursed-ordinals/balance.json")));
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.true;
+    });
+});

package/test/unit/AllowedEmbells.spec.js

@@ -0,0 +1,11 @@
+const { EmblemVaultSDK } = require('../../dist/index.js');
+const { expect } = require('chai');
+
+describe('Allowed Function for Embells', function() {
+    const sdk = new EmblemVaultSDK('DEMO_KEY');
+
+    it('Always allowed', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('Embels');
+        expect(curatedContract.allowed()).to.be.true;
+    });
+});

package/test/unit/AllowedEmbels.spec.js

@@ -0,0 +1,11 @@
+const { EmblemVaultSDK } = require('../../dist/index.js');
+const { expect } = require('chai');
+
+describe('Allowed Function for Embels', function() {
+    const sdk = new EmblemVaultSDK('DEMO_KEY');
+
+    it('Always allowed', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('Embels');
+        expect(curatedContract.allowed()).to.be.true;
+    });
+});

package/test/unit/AllowedEmblemOpen.spec.js

@@ -0,0 +1,20 @@
+const { EmblemVaultSDK } = require('../../dist/index.js');
+const { expect } = require('chai');
+const fs = require('fs');
+const path = require('path');
+
+describe('Allowed Function for EmblemOpen', function() {
+    const sdk = new EmblemVaultSDK('DEMO_KEY');
+
+    it('Does not allow empty balance', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('EmblemOpen');
+        expect(curatedContract.allowed(null, curatedContract)).to.be.false;
+        expect(curatedContract.allowed([], curatedContract)).to.be.false;
+    });
+
+    it('Allows any asset', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('EmblemOpen');
+        const balanceValues = JSON.parse(fs.readFileSync(path.join(__dirname, "../fixtures/emblem-open/balance.json")));
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.true;
+    });
+});

package/test/unit/AllowedEthscriptions.spec.js

@@ -0,0 +1,53 @@
+const { EmblemVaultSDK } = require('../../dist/index.js');
+const { expect } = require('chai');
+const fs = require('fs');
+const path = require('path');
+
+describe('Allowed Function for Ethscriptions', function() {
+    // Set timeout for all tests in this suite
+    this.timeout(10000);
+    
+    const sdk = new EmblemVaultSDK('DEMO_KEY');
+
+    it('Does not allow empty balance', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('Ethscription');
+        expect(curatedContract.allowed(null, curatedContract)).to.be.false;
+        expect(curatedContract.allowed([], curatedContract)).to.be.false;
+    });
+
+    it("Requires coin to match collectionChain case-insensitively", async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('Ethscription');
+        const balanceValues = JSON.parse(fs.readFileSync(path.join(__dirname, "../fixtures/ethscriptions/balance.json")));
+        // For protocol collections, the coin must match the collectionChain (case insensitive)
+        balanceValues[0].coin = "invalid coin";
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.false;
+        
+        // Should pass with the correct coin matching collectionChain (case insensitive)
+        // Note: The fixture uses "ethscription" (singular) while the collectionChain is "Ethscriptions" (plural)
+        // The validation should be case-insensitive but the actual value needs to match exactly
+        balanceValues[0].coin = "ethscription"; // exact match to the fixture
+        balanceValues[0].project = "Ethscription"; // Add project property matching the contract name
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.true;
+    });
+
+    it('Requires first balance value to be an ethscription', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('Ethscription');
+        const balanceValues = JSON.parse(fs.readFileSync(path.join(__dirname, "../fixtures/ethscriptions/balance-with-native-first.json")));
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.false;
+    });
+
+    it('Allows non-ethscription balances if not first', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('Ethscription');
+        const balanceValues = JSON.parse(fs.readFileSync(path.join(__dirname, "../fixtures/ethscriptions/balance-with-native.json")));
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.true;
+    });
+
+    it('Allows valid balances', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('Ethscription');
+        const balanceValues = JSON.parse(fs.readFileSync(path.join(__dirname, "../fixtures/ethscriptions/balance.json")));
+        // Make sure the coin matches the collectionChain for protocol collections (case insensitive)
+        balanceValues[0].coin = "ethscription"; // exact match to the fixture
+        balanceValues[0].project = "Ethscription"; // Add project property matching the contract name
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.true;
+    });
+});

package/test/unit/AllowedHardcodedNfts.spec.js

@@ -0,0 +1,77 @@
+const { EmblemVaultSDK } = require('../../dist/index.js');
+const { NFT_DATA } = require('../../dist/utils.js');
+const { expect } = require('chai');
+const fs = require('fs');
+const path = require('path');
+
+describe('Allowed Function for Hardcoded NFTs (XCP)', function() {
+    const sdk = new EmblemVaultSDK('DEMO_KEY');
+
+    it('Does not allow empty balance', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('Age of Chains');
+        expect(curatedContract.allowed(null, curatedContract)).to.be.false;
+        expect(curatedContract.allowed([], curatedContract)).to.be.false;
+    });
+
+    it('Requires asset name to be present in hardcoded metadata', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('Age of Chains');
+        const balanceValues = JSON.parse(fs.readFileSync(path.join(__dirname, "../fixtures/hardcoded-nfts/balance.json")));
+        balanceValues[0].name = 'invalid name';
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.false;
+    });
+
+    it('Requires projectName in hardcoded data to match curated collection name (case insensitive)', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('Age of Chains');
+        const balanceValues = JSON.parse(fs.readFileSync(path.join(__dirname, "../fixtures/hardcoded-nfts/balance.json")));
+        const hardcodedData = NFT_DATA[balanceValues[0]['name']];
+        const validProjectName = hardcodedData['projectName'];
+        
+        NFT_DATA[balanceValues[0]['name']]['projectName'] = validProjectName.toUpperCase();
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.true;
+
+        NFT_DATA[balanceValues[0]['name']]['projectName'] = 'invalid name';
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.false;
+
+        NFT_DATA[balanceValues[0]['name']]['projectName'] = validProjectName;
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.true;
+    });
+
+    it('Requires asset project to match curated collection name', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('Age of Chains');
+        const balanceValues = JSON.parse(fs.readFileSync(path.join(__dirname, "../fixtures/hardcoded-nfts/balance.json")));
+        balanceValues[0].project = 'Invalid project';
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.false;
+    });
+
+    it('Requires first asset balance to be 1', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('Age of Chains');
+        const balanceValues = JSON.parse(fs.readFileSync(path.join(__dirname, "../fixtures/hardcoded-nfts/balance.json")));
+        balanceValues[0].balance = 2;
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.false;
+    });
+
+    it('Allows any coin', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('Age of Chains');
+        const balanceValues = JSON.parse(fs.readFileSync(path.join(__dirname, "../fixtures/hardcoded-nfts/balance.json")));
+        balanceValues[0].coin = 'some coin';
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.true;
+    });
+
+    it('Does not allow non hardcoded asset first', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('Age of Chains');
+        const balanceValues = JSON.parse(fs.readFileSync(path.join(__dirname, "../fixtures/hardcoded-nfts/balance-witn-non-hardcoded-first.json")));
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.false;
+    });
+
+    it('Allows non hardcoded assets if not first', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('Age of Chains');
+        const balanceValues = JSON.parse(fs.readFileSync(path.join(__dirname, "../fixtures/hardcoded-nfts/balance-witn-non-hardcoded.json")));
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.true;
+    });
+
+    it('Allows valid balances', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('Age of Chains');
+        const balanceValues = JSON.parse(fs.readFileSync(path.join(__dirname, "../fixtures/hardcoded-nfts/balance.json")));
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.true;
+    });
+});

package/test/unit/AllowedNamecoin.spec.js

@@ -0,0 +1,33 @@
+const { EmblemVaultSDK } = require('../../dist/index.js');
+const { expect } = require('chai');
+const fs = require('fs');
+const path = require('path');
+
+describe('Allowed Function for Namecoin', function() {
+    const sdk = new EmblemVaultSDK('DEMO_KEY');
+
+    it('Does not allow empty balance', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('Namecoin');
+        expect(curatedContract.allowed(null, curatedContract)).to.be.false;
+        expect(curatedContract.allowed([], curatedContract)).to.be.false;
+    });
+
+    it('Requires coin to be a native asset', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('Namecoin');
+        let balanceValues = JSON.parse(fs.readFileSync(path.join(__dirname, "../fixtures/namecoin/balance.json")));
+        balanceValues[0].coin = "invalid coin";
+        expect(curatedContract.allowed([], curatedContract)).to.be.false;
+        balanceValues[0].coin = null;
+        expect(curatedContract.allowed([], curatedContract)).to.be.false;
+    });
+
+    it('Allows native assets and NFTs in any order', async () => {
+        const curatedContract = await sdk.fetchCuratedContractByName('Namecoin');
+        let balanceValues = JSON.parse(fs.readFileSync(path.join(__dirname, "../fixtures/namecoin/balance.json")));
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.true;
+        balanceValues = JSON.parse(fs.readFileSync(path.join(__dirname, "../fixtures/namecoin/balance-with-native.json")));
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.true;
+        balanceValues = JSON.parse(fs.readFileSync(path.join(__dirname, "../fixtures/namecoin/balance-with-native-first.json")));
+        expect(curatedContract.allowed(balanceValues, curatedContract)).to.be.true;
+    });
+});