@feralfile/cli 2.6.0 → 2.7.0

package/config.json.example

@@ -15,7 +15,7 @@
   ],
   "playlist": {
     "privateKey": "YOUR_ED25519_PRIVATE_KEY__base64_PKCS8_DER_recommended__or_32byte_raw_seed_as_hex_or_base64__run_ff-cli_setup_to_generate",
-    "role": "agent",
+    "role": "curator",
     "curatorName": "YOUR_CURATOR_NAME"
   },
   "ff1Relayer": {

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@feralfile/cli",
-    "version": "2.6.0",
+    "version": "2.7.0",
     "description": "CLI for building, signing, and playing DP-1 playlists of digital art on Feral File devices",
     "repository": {
         "type": "git",

package/dist/src/commands/find.js

@@ -1,37 +1,4 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -595,8 +562,8 @@ async function doPlay(playlist, deviceName, skipVerify) {
 }
 async function doPublish(savedPath, serverArg, nonInteractive) {
     console.log(chalk_1.default.blue('Publish to feed'));
-    const { getFeedConfig } = await Promise.resolve().then(() => __importStar(require('../config')));
-    const { publishPlaylist } = await Promise.resolve().then(() => __importStar(require('../utilities/playlist-publisher')));
+    const { getFeedConfig } = await import('../config.js');
+    const { publishPlaylist } = await import('../utilities/playlist-publisher.js');
     const feedConfig = getFeedConfig();
     if (!feedConfig.baseURLs || feedConfig.baseURLs.length === 0) {
         console.error(chalk_1.default.red('No feed servers configured.'));

package/dist/src/commands/helpers/playlist-display.js

@@ -1,37 +1,4 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -98,7 +65,7 @@ function printPlaylistVerificationFailure(verifyResult, source) {
  */
 async function validatePlaylistSource(source) {
     const loaded = await (0, playlist_source_1.loadPlaylistSource)(source);
-    const verifier = await Promise.resolve().then(() => __importStar(require('../../utilities/playlist-verifier')));
+    const verifier = await import('../../utilities/playlist-verifier.js');
     const { validatePlaylist } = verifier;
     const verifyResult = await validatePlaylist(loaded.playlist);
     return {
@@ -113,7 +80,7 @@ async function validatePlaylistSource(source) {
 async function runValidateCommand(source) {
     try {
         console.log(chalk_1.default.blue('\nValidate playlist\n'));
-        const verifier = await Promise.resolve().then(() => __importStar(require('../../utilities/playlist-verifier')));
+        const verifier = await import('../../utilities/playlist-verifier.js');
         const { printVerificationResult } = verifier;
         const result = await validatePlaylistSource(source);
         printVerificationResult(result, source, { failureKind: 'structure' });
@@ -138,7 +105,7 @@ async function runValidateCommand(source) {
 async function runVerifyCommand(source, publicKey) {
     try {
         console.log(chalk_1.default.blue('\nVerify playlist\n'));
-        const verifier = await Promise.resolve().then(() => __importStar(require('../../utilities/playlist-verifier')));
+        const verifier = await import('../../utilities/playlist-verifier.js');
         const { printVerificationResult } = verifier;
         const result = await validatePlaylistSource(source);
         if (!result.valid) {

package/dist/src/commands/publish.js

@@ -1,37 +1,4 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -47,8 +14,8 @@ exports.publishCommand = new commander_1.Command('publish')
     .action(async (file, options) => {
     try {
         console.log(chalk_1.default.blue('\nPublish playlist\n'));
-        const { getFeedConfig } = await Promise.resolve().then(() => __importStar(require('../config')));
-        const { publishPlaylist } = await Promise.resolve().then(() => __importStar(require('../utilities/playlist-publisher')));
+        const { getFeedConfig } = await import('../config.js');
+        const { publishPlaylist } = await import('../utilities/playlist-publisher.js');
         const feedConfig = getFeedConfig();
         if (!feedConfig.baseURLs || feedConfig.baseURLs.length === 0) {
             console.error(chalk_1.default.red('\nNo feed servers configured'));

package/dist/src/commands/ssh.js

@@ -1,37 +1,4 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -71,7 +38,7 @@ exports.sshCommand = new commander_1.Command('ssh')
         if (options.ttl) {
             ttlSeconds = (0, ssh_helpers_1.parseTtlSeconds)(options.ttl);
         }
-        const { sendSshAccessCommand } = await Promise.resolve().then(() => __importStar(require('../utilities/ssh-access')));
+        const { sendSshAccessCommand } = await import('../utilities/ssh-access.js');
         const result = await sendSshAccessCommand({
             enabled: isEnable,
             deviceName: options.device,

package/dist/src/utilities/feed-fetcher.js

@@ -1,3 +1,4 @@
+"use strict";
 /**
  * DP1 Feed Fetcher
  * Utilities to fetch playlists from DP1 Feed API

package/dist/src/utilities/functions.js

@@ -1,40 +1,8 @@
+"use strict";
 /**
  * Function Calling Layer
  * These are the actual implementations called by AI orchestrator via function calling
  */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 const chalk = require('chalk');
 const playlistBuilder = require('./playlist-builder');
 const ff1Device = require('./ff1-device');
@@ -162,7 +130,7 @@ async function verifyPlaylist(params) {
     }
     logger.verbose(chalk.cyan('\nValidate playlist'));
     // Dynamic import to avoid circular dependency
-    const playlistVerifier = await Promise.resolve().then(() => __importStar(require('./playlist-verifier')));
+    const playlistVerifier = await import('./playlist-verifier.js');
     const validate = playlistVerifier.validatePlaylist ||
         (playlistVerifier.default && playlistVerifier.default.validatePlaylist) ||
         playlistVerifier.default;
@@ -226,7 +194,7 @@ async function verifyAddresses(params) {
         };
     }
     // Dynamic import to avoid circular dependency
-    const addressValidator = await Promise.resolve().then(() => __importStar(require('./address-validator')));
+    const addressValidator = await import('./address-validator.js');
     const validateAddresses = addressValidator.validateAddresses ||
         (addressValidator.default && addressValidator.default.validateAddresses) ||
         addressValidator.default;
@@ -268,7 +236,7 @@ async function verifyAddresses(params) {
  * }
  */
 async function getConfiguredDevices() {
-    const configModule = await Promise.resolve().then(() => __importStar(require('../config')));
+    const configModule = await import('../config.js');
     const getFF1DeviceConfig = configModule.getFF1DeviceConfig ||
         (configModule.default && configModule.default.getFF1DeviceConfig) ||
         configModule.default;

package/dist/src/utilities/index.js

@@ -1,40 +1,8 @@
+"use strict";
 /**
  * Utilities - Actual function implementations
  * Contains the real logic for querying NFTs and building playlists
  */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 const chalk = require('chalk');
 const nftIndexer = require('./nft-indexer');
 const feedFetcher = require('./feed-fetcher');
@@ -400,7 +368,7 @@ async function buildDP1Playlist(items, title, slug) {
  * @returns {Promise<Object>} Result
  */
 async function sendToDevice(playlist, deviceName) {
-    const playlistVerifier = await Promise.resolve().then(() => __importStar(require('./playlist-verifier')));
+    const playlistVerifier = await import('./playlist-verifier.js');
     const verifyPlaylist = playlistVerifier.verifyPlaylist ||
         (playlistVerifier.default && playlistVerifier.default.verifyPlaylist) ||
         playlistVerifier.default;

package/dist/src/utilities/nft-indexer.js

@@ -1,3 +1,4 @@
+"use strict";
 /**
  * NFT Indexer Client
  * This module provides functions to interact with NFT indexing services
@@ -48,8 +49,15 @@ const JOB_STATUS_QUERY = `
 /**
  * buildTokensListQuery builds the `tokens { items { ... } }` request body used by queryTokens.
  *
- * Selection uses only `display` and `media_assets`. The indexer merges metadata and enrichment
- * into `display`; the client does not repeat that merge by fetching raw metadata fields.
+ * Presentation comes only from `display` and `media_assets`. The indexer merges metadata and
+ * enrichment into `display`; the client does not repeat that merge by fetching raw metadata fields.
+ *
+ * `chain` and `standard` are selected because the row is the only place either fact is known.
+ * `detectTokenStandard` has an address and a chain name and nothing else, so it answers `erc721` for
+ * every EVM contract — which wrote `erc721` into playlists for every ERC-1155 token `find` reached by
+ * owner or by contract. The indexer stores what the token actually is (`erc721`, `erc1155`, `fa2`)
+ * beside its CAIP-2 `chain` (`eip155:1`, `tezos:mainnet`), so the row answers both questions and
+ * detection drops to a fallback. Do not remove these two fields from the selection.
  *
  * @param {Object} [params]
  * @param {Array<string>} [params.token_cids]
@@ -74,6 +82,8 @@ function buildTokensListQuery(params = {}) {
           token_number
           current_owner
           burned
+          chain
+          standard
           display {
             name
             description
@@ -106,10 +116,18 @@ function initializeIndexer(_config) {
     logger.debug('[NFT Indexer] Using endpoint:', GRAPHQL_ENDPOINT);
 }
 /**
- * Detect token standard based on chain and contract address
+ * detectTokenStandard guesses a token standard from a chain name and an address.
+ *
+ * This is the last-resort fallback, not the answer. It sees no token — only a
+ * chain name and an address format — so it cannot tell ERC-721 from ERC-1155
+ * and answers `erc721` for every EVM contract. It is still needed in two
+ * places: a lookup by coordinate has to build *some* CID before the indexer has
+ * been asked anything (see buildTokenCID), and a token row that arrived without
+ * a `standard` field has nothing better to offer.
  *
- * Determines the appropriate ERC/token standard for the given blockchain
- * and contract format.
+ * Prefer, in order: the indexer row's own `standard`, a caller's assertion, and
+ * only then this. On-chain detection is deliberately not attempted here — the
+ * indexer already stores the answer and selecting it costs nothing.
  *
  * @param {string} chain - Blockchain network
  * @param {string} contractAddress - Contract address
@@ -121,18 +139,34 @@ function detectTokenStandard(chain, contractAddress) {
     if (lowerChain === 'tezos' || contractAddress.startsWith('KT')) {
         return 'fa2';
     }
-    // Ethereum uses ERC721
-    // TODO: Enhance with on-chain detection for ERC1155 support
+    // Ethereum: erc721 is a guess, not a reading. Only the indexer row or a
+    // caller's assertion can distinguish an ERC-1155 token from an ERC-721 one.
     if (lowerChain === 'ethereum') {
         return 'erc721';
     }
     return 'other';
 }
 /**
- * Token standards the indexer keys CIDs on. An asserted standard outside this
- * set says nothing the CID can carry, so detection decides instead.
+ * Token standards the indexer keys CIDs on. A standard outside this set —
+ * asserted by a caller or arriving on a row — says nothing the CID can carry,
+ * so detection decides instead.
  */
 const CID_STANDARDS = new Set(['erc721', 'erc1155', 'fa2']);
+/**
+ * normalizeCidStandard returns a standard the CID format can carry, or ''.
+ *
+ * Both the indexer row and a caller's assertion are untrusted strings from
+ * outside this module ('ERC1155', ' fa2 ', 'ERC-1155', undefined). Anything not
+ * in CID_STANDARDS is treated as absent rather than passed through, so a
+ * misspelled standard never reaches a CID or a DP-1 `provenance.contract`.
+ *
+ * @param {unknown} value - Candidate standard
+ * @returns {string} Normalized standard, or '' when it is not one we can use
+ */
+function normalizeCidStandard(value) {
+    const normalized = typeof value === 'string' ? value.trim().toLowerCase() : '';
+    return CID_STANDARDS.has(normalized) ? normalized : '';
+}
 /**
  * resolveTokenStandard picks the standard a CID is built with.
  *
@@ -149,11 +183,77 @@ const CID_STANDARDS = new Set(['erc721', 'erc1155', 'fa2']);
  * @returns {string} Token standard for the CID
  */
 function resolveTokenStandard(chain, contractAddress, asserted) {
-    const normalized = typeof asserted === 'string' ? asserted.trim().toLowerCase() : '';
-    if (CID_STANDARDS.has(normalized)) {
-        return normalized;
+    return normalizeCidStandard(asserted) || detectTokenStandard(chain, contractAddress);
+}
+/**
+ * CAIP-2 namespaces mapped to the chain values DP-1 `provenance.contract` allows.
+ *
+ * The indexer names a token's chain in CAIP-2 (`eip155:1`, `tezos:mainnet`),
+ * which is authoritative: it comes from the row rather than from the caller's
+ * guess at which network an address belongs to. Namespaces outside this map
+ * have no DP-1 equivalent, so they fall back to the caller's chain name.
+ */
+const CAIP2_NAMESPACE_TO_DP1_CHAIN = {
+    eip155: 'evm',
+    tezos: 'tezos',
+    bitmark: 'bitmark',
+};
+/**
+ * dp1ChainFromCaip2 derives a DP-1 chain from a CAIP-2 chain id.
+ *
+ * @param {unknown} caip2Chain - CAIP-2 chain id from an indexer row, e.g. `eip155:1`
+ * @returns {string} DP-1 chain (`evm`, `tezos`, `bitmark`), or '' when unknown or absent
+ */
+function dp1ChainFromCaip2(caip2Chain) {
+    if (typeof caip2Chain !== 'string') {
+        return '';
     }
-    return detectTokenStandard(chain, contractAddress);
+    const namespace = caip2Chain.trim().toLowerCase().split(':')[0];
+    return CAIP2_NAMESPACE_TO_DP1_CHAIN[namespace] || '';
+}
+/**
+ * Client chain names mapped to the chain values DP-1 `provenance.contract` allows.
+ *
+ * This is for DP-1 provenance output, NOT for indexer queries: the indexer uses
+ * `eth`/`tez`/`bmk` while DP-1 uses `evm`/`tezos`/`bitmark`. It answers only for
+ * tokens that reached us without an indexer row — a caller-supplied coordinate.
+ */
+const CHAIN_NAME_TO_DP1_CHAIN = {
+    ethereum: 'evm',
+    polygon: 'evm',
+    arbitrum: 'evm',
+    optimism: 'evm',
+    base: 'evm',
+    zora: 'evm',
+    tezos: 'tezos', // DP1 spec uses 'tezos', not 'tez'
+    bitmark: 'bitmark', // DP1 spec uses 'bitmark', not 'bmk'
+};
+/**
+ * resolveDp1Chain picks the DP-1 chain for a token's `provenance.contract`.
+ *
+ * The row's CAIP-2 chain and the caller's chain name are not two guesses to try
+ * in turn — they are different claims, and the row's is the network the indexer
+ * recorded. So a token carrying a row chain is answered from that chain alone:
+ * a namespace with no DP-1 equivalent becomes `other`, never the caller's name.
+ * Falling through would be actively wrong, because the owner and contract paths
+ * label every non-KT address `ethereum` before mapping — a Solana row would
+ * inherit that label and be published as an EVM contract. `other` is a true
+ * statement about a chain DP-1 cannot name; `evm` is a false one.
+ *
+ * The name map answers only when the token has no row chain at all, which is a
+ * token assembled from a caller-supplied coordinate rather than an indexer row.
+ *
+ * @param {Object} token - Token in the internal standard format
+ * @param {string} [token.caip2Chain] - CAIP-2 chain from the indexer row, when it came from one
+ * @param {string} [token.chain] - Client chain name the caller inferred
+ * @returns {string} DP-1 chain (`evm`, `tezos`, `bitmark`, or `other`)
+ */
+function resolveDp1Chain(token) {
+    const rowChain = typeof token.caip2Chain === 'string' ? token.caip2Chain.trim() : '';
+    if (rowChain) {
+        return dp1ChainFromCaip2(rowChain) || 'other';
+    }
+    return CHAIN_NAME_TO_DP1_CHAIN[String(token.chain || '').toLowerCase()] || 'other';
 }
 /**
  * Build CAIP-2 token CID for indexer v2
@@ -348,9 +448,16 @@ function getBestMediaUrl(display = {}, mediaAssets = []) {
  * is null or partial, we only use what is present (for example `Token #${token_number}` for name);
  * we do not splice in raw `metadata` or enrichment because those are not selected from GraphQL.
  *
+ * The row's own `standard` and `chain` outrank both the asserted `standard` and the `chain`
+ * argument, because they are the token's identity as the indexer recorded it while the arguments are
+ * the caller's inference — `find` by owner or by contract only knows "the address starts with 0x, so
+ * ethereum". Precedence for the standard is row → asserted → detection; the CAIP-2 `chain` is kept
+ * beside the caller's chain name (not in place of it) as `caip2Chain`, because the name still selects
+ * the CID prefix and the detection fallback while the CAIP-2 value answers DP-1's chain enum.
+ *
  * @param {Object} indexerData - Token fields from indexer GraphQL
- * @param {string} chain - Blockchain network
- * @param {string} [standard] - Asserted token standard; detected when omitted
+ * @param {string} chain - Blockchain network the caller inferred
+ * @param {string} [standard] - Asserted token standard; used when the row carries none
  * @returns {Object} Standardized token data
  */
 function mapIndexerDataToStandardFormat(indexerData, chain, standard) {
@@ -366,11 +473,14 @@ function mapIndexerDataToStandardFormat(indexerData, chain, standard) {
     const artistName = extractArtistName(display.artists);
     const name = display.name || `Token #${indexerData.token_number}`;
     const description = display.description || '';
-    const resolvedStandard = resolveTokenStandard(chain, indexerData.contract_address, standard);
+    const resolvedStandard = normalizeCidStandard(indexerData.standard) ||
+        resolveTokenStandard(chain, indexerData.contract_address, standard);
+    const caip2Chain = typeof indexerData.chain === 'string' ? indexerData.chain : '';
     return {
         success: true,
         token: {
             chain,
+            caip2Chain,
             contractAddress: indexerData.contract_address,
             tokenId: indexerData.token_number,
             standard: resolvedStandard,
@@ -470,26 +580,13 @@ function convertToDP1Item(tokenData, duration) {
             error: `Source URL too long (${sourceUrl.length} chars, max 1024)`,
         };
     }
-    // Map chain name to DP1 format (according to DP1 spec)
-    // NOTE: This is for DP1 provenance output, NOT for indexer queries
-    // The indexer uses 'eth'/'tez'/'bmk', but DP1 spec uses 'evm'/'tezos'/'bitmark'
-    const chainMap = {
-        ethereum: 'evm',
-        polygon: 'evm',
-        arbitrum: 'evm',
-        optimism: 'evm',
-        base: 'evm',
-        zora: 'evm',
-        tezos: 'tezos', // DP1 spec uses 'tezos', not 'tez'
-        bitmark: 'bitmark', // DP1 spec uses 'bitmark', not 'bmk'
-    };
     // Build via dp1-js PlaylistItemBuilder so leaf blocks match DP-1 AJV schema.
     const itemBuilder = new PlaylistItemBuilder()
         .id(itemId)
         .source(sourceUrl)
         .license('open')
         .provenance(new ProvenanceBuilder().type('onChain').contract(new ContractBuilder()
-        .chain(chainMap[token.chain.toLowerCase()] || 'other')
+        .chain(resolveDp1Chain(token))
         .standard(token.standard || detectTokenStandard(token.chain, token.contractAddress))
         .address(token.contractAddress)
         .tokenId(String(token.tokenId))));

package/dist/src/utilities/playlist-builder.js

@@ -1,3 +1,4 @@
+"use strict";
 /**
  * Playlist Builder Utilities
  *

package/dist/src/utilities/playlist-cast.js

@@ -1,37 +1,4 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.castPlaylist = castPlaylist;
 /**
@@ -106,7 +73,7 @@ async function castPlaylist(playlist, options = {}) {
                 };
             }
         }
-        const { verifyPlaylist } = await Promise.resolve().then(() => __importStar(require('./playlist-verifier')));
+        const { verifyPlaylist } = await import('./playlist-verifier.js');
         const verifyResult = await verifyPlaylist(current);
         if (!verifyResult.valid) {
             return {

package/dist/src/utilities/playlist-send.js

@@ -1,37 +1,4 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -46,7 +13,7 @@ const playlist_source_1 = require("./playlist-source");
  */
 async function getAvailableDevices() {
     try {
-        const configModule = (await Promise.resolve().then(() => __importStar(require('../config'))));
+        const configModule = (await import('../config.js'));
         const getFF1DeviceConfig = configModule.getFF1DeviceConfig ||
             (configModule.default && configModule.default.getFF1DeviceConfig) ||
             configModule.default;
@@ -146,7 +113,7 @@ async function confirmPlaylistForSending(filePath, deviceName) {
         // Parse / structure validation only (same as `validate`; use `verify` CLI for signatures)
         console.log(chalk_1.default.cyan('Validation'));
         // Dynamic import to avoid circular dependency
-        const { validatePlaylist } = await Promise.resolve().then(() => __importStar(require('./playlist-verifier')));
+        const { validatePlaylist } = await import('./playlist-verifier.js');
         const validateResult = await validatePlaylist(playlist);
         if (!validateResult.valid) {
             console.log(chalk_1.default.red('Playlist validation failed'));

package/dist/src/utilities/playlist-signer.js

@@ -1,40 +1,8 @@
+"use strict";
 /**
  * Playlist Signing Utility.
  * Uses the DP-1 v1.1.0 signing contract via the `dp1-js` package.
  */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 const { getPlaylistConfig } = require('../config');
 const { isDp1PlaylistSigningRole } = require('./playlist-signing-role');
 const { parsePlaylistPrivateKeyToKeyObject } = require('./ed25519-key-derive');
@@ -261,7 +229,7 @@ async function verifySignedPlaylistEnvelope(signedPlaylist, dp1) {
  * instead of leaving a runtime require that can't resolve.
  */
 async function loadDp1() {
-    return Promise.resolve().then(() => __importStar(require('dp1-js')));
+    return import('dp1-js');
 }
 function currentTimestamp() {
     return new Date().toISOString().replace(/\.\d{3}Z$/, 'Z');

package/dist/src/utilities/playlist-signing-role.js

@@ -1,3 +1,4 @@
+"use strict";
 /**
  * Supported DP-1 playlist signing roles.
  *

package/dist/src/utilities/playlist-verifier.js

@@ -4,39 +4,6 @@
  * Delegates signature-shape handling to dp1-js and keeps the CLI as a thin
  * orchestration layer.
  */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -84,10 +51,10 @@ async function verifyPlaylist(playlist, publicKey) {
         let key = publicKey?.trim() || undefined;
         if (!key) {
             try {
-                const { getPlaylistConfig } = await Promise.resolve().then(() => __importStar(require('../config')));
+                const { getPlaylistConfig } = await import('../config.js');
                 const privateKeyMaterial = getPlaylistConfig().privateKey;
                 if (privateKeyMaterial) {
-                    const { deriveEd25519PublicKeyForVerify } = await Promise.resolve().then(() => __importStar(require('./ed25519-key-derive')));
+                    const { deriveEd25519PublicKeyForVerify } = await import('./ed25519-key-derive.js');
                     key = deriveEd25519PublicKeyForVerify(privateKeyMaterial);
                 }
             }
@@ -98,7 +65,7 @@ async function verifyPlaylist(playlist, publicKey) {
         }
         if (key) {
             try {
-                const { normalizeVerifyPublicKeyToPem } = await Promise.resolve().then(() => __importStar(require('./ed25519-key-derive')));
+                const { normalizeVerifyPublicKeyToPem } = await import('./ed25519-key-derive.js');
                 key = normalizeVerifyPublicKeyToPem(key);
             }
             catch (err) {
@@ -162,7 +129,7 @@ async function parseDp1Playlist(playlist) {
  * stays lazy, so dp1-js's transitive deps don't load on unrelated commands.
  */
 async function loadDp1() {
-    return (await Promise.resolve().then(() => __importStar(require('dp1-js'))));
+    return (await import('dp1-js'));
 }
 /**
  * Verify playlist file

package/docs/CONFIGURATION.md

@@ -63,7 +63,7 @@ Used for signing DP‑1 playlists.
   `PLAYLIST_PRIVATE_KEY` even when no config file exists yet, and `ff-cli status --key <privateKey>`
   reports it for an explicit key — the one `sign --key` would use.
 
-- `playlist.role` (string): DP-1 signing role used by `ff-cli sign`. Defaults to `agent` if omitted. You can also set this via `PLAYLIST_ROLE` in `.env`. Guided `ff-cli setup`, `config validate`, and `sign --role` only accept the usual DP-1 signing roles (`agent`, `feed`, `curator`, `institution`, `licensor`). It does **not** apply to `find` and `build`, which always sign as `curator` — see [Signing role and ownership](#signing-role-and-ownership).
+- `playlist.role` (string): DP-1 signing role used by `ff-cli sign`. The shipped `config.json.example` sets `curator`, because a document signed as `agent` is ownerless to a role-aware feed and `ff-cli publish` refuses it. The code default when the key is omitted entirely is still `agent`. You can also set this via `PLAYLIST_ROLE` in `.env`. Guided `ff-cli setup`, `config validate`, and `sign --role` only accept the usual DP-1 signing roles (`agent`, `feed`, `curator`, `institution`, `licensor`). It does **not** apply to `find` and `build`, which always sign as `curator` — see [Signing role and ownership](#signing-role-and-ownership).
 
 ### Generate an Ed25519 private key
 
@@ -267,7 +267,7 @@ Minimal `config.json` example (selected fields):
   "defaultDuration": 10,
   "playlist": {
     "privateKey": "your_ed25519_private_key_hex_or_base64_here",
-    "role": "agent"
+    "role": "curator"
   },
   "feed": {
     "baseURLs": ["https://dp1-feed-operator-api-prod.autonomy-system.workers.dev/api/v1"]

package/docs/PROJECT_SPEC.md

@@ -159,6 +159,16 @@ Today the CLI groups into these workflow areas:
 - `find`
 - `build`
 
+An item's `provenance.contract` is read from the indexer row, not inferred. Each
+row carries the token's own `standard` (`erc721`, `erc1155`, `fa2`) and its
+CAIP-2 `chain` (`eip155:1`, `tezos:mainnet`), and both are written through. The
+client's own detection sees a chain name and an address and nothing else, so it
+answers `erc721` for every EVM contract; it applies only to rows that carry no
+standard, and to the CID a lookup by coordinate must build before the indexer
+has been asked anything. A row naming a chain DP-1 has no word for is recorded
+as `other` — the item is still built, and the client's guess is never
+substituted for a chain the row already named.
+
 ### DP-1 output integrity
 
 - `verify`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@feralfile/cli",
-  "version": "2.6.0",
+  "version": "2.7.0",
   "description": "CLI for building, signing, and playing DP-1 playlists of digital art on Feral File devices",
   "repository": {
     "type": "git",