Protocole

Référence des contrats et des statuts

Définitions détaillées des statuts, règles de signature et capacités publiées de l’API.

Acheter une action et détenir un indice sont des produits différents

Ils diffèrent par ce que vous détenez, qui en a la garde et comment vous pouvez sortir. L’interface distingue toujours les deux.

Différence	Acheter directementjeton dans votre portefeuille	Détenir un indiceparts de coffre
Ce que vous détenez	Le jeton bStock lui-même, à sa propre adresse de contrat.	Des parts ERC-20 d’un coffre qui détient le panier.
Garde	Votre portefeuille. Après l’échange, aucun de nos systèmes ne détient le jeton.	Un contrat non dépositaire. Aucun portefeuille de la plateforme ne détient les actifs des utilisateurs.
Comment sortir	Le revendre via le même routage, lorsqu’un routage existe.	Rachat en nature au prorata : vous recevez les jetons sous-jacents, pas des espèces.
Restrictions de l’émetteur	Elles s’appliquent directement à vous. Un gel bloque votre transfert.	Elles s’appliquent à chaque transfert. Un seul transfert restreint annule tout le rachat.
Prix utilisé pour l’opération	Une cotation exécutable avec une échéance et un montant minimal reçu.	Un aperçu à un bloc fixe. Il ne promet pas une exécution.
Rééquilibrage	À votre initiative. Nous ne détenons aucune position et n’envoyons aucune instruction.	Uniquement selon une composition examinée, sous gouvernance et dans des limites fixes.
À choisir si	Vous voulez une seule valeur et détenir le jeton vous-même.	Vous souhaitez une exposition thématique dans une seule position, avec des pondérations vérifiées par le contrat.

Points communs aux deux

L’actif est identifié par la chaîne et l’adresse, jamais par le symbole. Il a été admis au moyen de la même chaîne de preuves. L’émetteur peut geler ou restreindre les deux voies, et aucune ne garantit la sortie.

Ce qui est ouvert aujourd’hui

L’exécution dépend de la voie choisie : les parts d’indices nécessitent les capacités actuelles d’un coffre enregistré sur la chaîne concernée ; l’achat direct nécessite un routage exécutable et une profondeur mesurée. Les adresses configurées, les preuves de test et l’autorisation de production sont distinctes.

Statut de vérification

Provenance des sources et du code. Ce statut ne dit pas si l’actif peut être utilisé.

Statut technique sur testnet · DISCOVERED	Importé comme candidat à partir d’une source archivée. Rien n’est encore confirmé.
Statut technique sur testnet · SOURCE_REVIEW	Le document de l’émetteur est en cours d’examen.
Statut technique sur testnet · ONCHAIN_VERIFIED	Des preuves des capacités sur la chaîne ont été consignées à un bloc fixe.
Statut technique sur testnet · VERIFIED	La source et les preuves sur la chaîne ont été examinées et approuvées indépendamment.
Statut technique sur testnet · REVOKED	Une approbation antérieure a été retirée. Considérez cet actif comme non vérifié.

Autorisation d’opération

Indique si un actif peut être utilisé, et dans quel sens. Cette décision est indépendante de la vérification.

Consultation seule	Consultation uniquement. Aucune nouvelle exposition ni utilisation dans un fonds.
Actif	Les opérations sont autorisées selon les règles actuelles du registre.
Sortie uniquement	Aucune nouvelle exposition. Les positions existantes peuvent être liquidées.
Suspendu	Les sorties concernées sont également interdites. Attendez-vous à un échec des opérations.
Révoqué	État définitif. Aucune nouvelle exposition ; sortie possible uniquement si le jeton autorise encore le transfert.

Pourquoi ces deux états sont distincts

Un actif peut avoir une source entièrement vérifiée et rester en consultation seule ; un actif précédemment actif peut être suspendu sans changement de ses preuves. Fusionner ces deux états dans un seul badge masquerait la différence entre « nous avons vérifié le document de l’émetteur » et « vous pouvez composer un fonds avec cet actif ».

État des capacités

L’API répond 503 CAPABILITY_UNAVAILABLE pour une capacité non implémentée. Cette interface l’affiche comme indisponible. Elle ne remplace jamais cette réponse par une liste vide, un solde nul ou une transaction réussie.

Capacité	Point d’accès	État	Signature d’écriture
Répertoire du registre d’actifs	GET /v1/assets	Implémentée	Lecture
Provenance de la vérification des actifs	GET /v1/assets/{address}/verification	Implémentée	Lecture
Sources officielles archivées	GET /v1/assets/{address}/sources	Implémentée	Lecture
Capacités du jeton à un bloc fixe	GET /v1/assets/{address}/capabilities	Implémentée	Lecture
Publication des prix de référence	GET /v1/assets/{address}/pricing	ImplémentéeNécessite un flux de prix sous licence ; réponse 503 en attendant	Lecture
Vérification publique d’une adresse	POST /v1/assets/verify	Implémentée	Lecture
Authentification par portefeuille	POST /v1/auth/verify	Implémentée	Lecture
Session et rôles	GET /v1/auth/session	Implémentée	Oui
Défi d’écriture métier	POST /v1/auth/operation-challenge	Implémentée	Oui
Découverte des stratégies publiées	GET /v1/indexes	Implémentée	Lecture
Brouillons de stratégies	POST /v1/indexes	Implémentée	Signature par requête
Publication de stratégies	POST /v1/indexes/{id}/publish	Implémentée	Signature par requête
Lien de partage en lecture seule	GET /v1/indexes/by-slug/{slug}	Implémentée	Lecture
Vérification déterministe des faits	GET /v1/indexes/{id}/advisory	ImplémentéeNécessite un flux de prix sous licence ; réponse 503 en attendant	Lecture
Test rétrospectif historique	GET /v1/indexes/{id}/backtest	ImplémentéeNécessite un flux de prix sous licence ; réponse 503 en attendant	Lecture
Liste de suivi personnelle	GET /v1/me/watchlist	Implémentée	Oui
Capacités de la chaîne et du déploiement en exécution	GET /v1/capabilities	Implémentée	Lecture
Aperçu canonique en nature sur testnet	GET /v1/funds/{id}/preview	ImplémentéeNécessite une adresse de contrat déployé	Lecture
Répertoire des fonds enregistrés	GET /v1/funds	Implémentée	Lecture
Positions du fonds à un bloc fixe	GET /v1/funds/{id}/holdings	ImplémentéeNécessite un instantané canonique à un bloc fixe ; réponse 503 en attendant	Lecture
Valeur liquidative de référence	GET /v1/funds/{id}/nav	ImplémentéeNécessite un flux de prix sous licence ; réponse 503 en attendant	Lecture
Historique discontinu de la valeur liquidative	GET /v1/funds/{id}/nav/history	ImplémentéeNécessite un flux de prix sous licence ; réponse 503 en attendant	Lecture
Activité du fonds	GET /v1/funds/{id}/transactions	ImplémentéeNécessite un instantané canonique à un bloc fixe ; réponse 503 en attendant	Lecture
Positions du portefeuille	GET /v1/portfolio	ImplémentéeNécessite un instantané canonique à un bloc fixe ; réponse 503 en attendant	Oui
Activité du portefeuille	GET /v1/portfolio/transactions	ImplémentéeNécessite un instantané canonique à un bloc fixe ; réponse 503 en attendant	Oui
Intentions de transaction	POST /v1/transactions/intents	Implémentée	Signature par requête
File d’examen des actifs	GET /v1/admin/assets/pending	Implémentée	Oui
Examen des sources d’actifs	POST /v1/admin/assets/{address}/review	Implémentée	Signature par requête
Activation des actifs	POST /v1/admin/assets/{address}/activate	Implémentée	Signature par requête
Demandes de fonds restreints	POST /v1/fund-applications	Implémentée	Signature par requête
Enregistrement de gouvernance du fonds	GET /v1/admin/funds/{id}/governance	Implémentée	Oui
Ancienne cotation de panier	GET /v1/quotes/basket	Absente du contratNon déclarée dans le contrat ; réponse 503	Lecture
Cotation d’achat d’un panier	POST /v1/quotes/basket-buy	ImplémentéeNécessite un fournisseur de routage approuvé ; réponse 503 par défaut, et toute réussite reste une simulation	Signature par requête
Cotation de vente d’un panier	POST /v1/quotes/basket-sell	ImplémentéeNécessite un fournisseur de routage approuvé ; réponse 503 par défaut, et toute réussite reste une simulation	Signature par requête
Cotation de dépôt au coffre	POST /v1/quotes/vault-deposit	ImplémentéeNécessite un fournisseur de routage approuvé ; réponse 503 par défaut, et toute réussite reste une simulation	Signature par requête
Cotation de rachat du coffre	POST /v1/quotes/vault-redeem	ImplémentéeNécessite un fournisseur de routage approuvé ; réponse 503 par défaut, et toute réussite reste une simulation	Signature par requête

Autorisation d’une écriture métier

Une session authentifiée prouve votre identité ; elle n’autorise pas une modification. Chaque écriture sérialise son corps une seule fois, calcule l’empreinte SHA-256 de ces octets exacts, demande au serveur un défi à usage unique lié à la méthode, au chemin et à l’empreinte, fait signer le message exact du serveur par le portefeuille, puis envoie les mêmes octets avec le nonce et la signature. Changer un octet, le chemin ou la méthode invalide la signature.

Un nonce déjà utilisé avec succès ne peut pas être réutilisé, et l’interface ne recrée jamais silencieusement le même enregistrement. Si une réponse est perdue, le résultat est recherché par nonce avant toute nouvelle tentative.

Ce que signifie l’authentification par portefeuille

L’authentification prouve que vous contrôlez une adresse, au moyen d’un message généré par le serveur. Elle autorise les appels à l’API pendant huit heures. Elle n’autorise jamais un transfert de jetons, une autorisation de dépense ou une opération de fonds, et ne confère aucun rôle d’examinateur ou de gouverneur.

Traitement des montants

Les quantités brutes de jetons sont des entiers, transportés en BigInt ou en chaînes décimales exactes. L’interface n’effectue aucun calcul en virgule flottante sur un montant et n’applique aucun multiplicateur tant que le contrat n’en publie pas l’échelle.

Risques et limites

Aucun point d’accès RPC configuré

Les lectures sur la chaîne sont désactivées dans ce déploiement. La connexion et l’authentification par portefeuille restent disponibles, car elles utilisent le fournisseur de votre portefeuille.

Transactions de production indisponibles

Les actions sur les contrats dépendent du déploiement et des conditions de lancement de la chaîne active. Une adresse testnet configurée n’active pas la production ; consultez la page du fonds pour connaître ses capacités actuelles sur testnet.

La production sur le réseau principal reste désactivée. Les déploiements sur testnet et les actifs de test synthétiques ne satisfont pas aux conditions de lancement en production.
Aucune source de prix, valeur liquidative de référence ou cotation exécutable n’est publiée. Un aperçu ne constitue jamais une promesse de cotation.
Les enregistrements importés des données initiales sont des candidats. Un candidat n’est ni vérifié ni négociable.
Les émetteurs d’actions tokenisées peuvent restreindre les transferts. Aucune interface ici ne peut garantir la sortie d’une position sur un jeton soumis à restriction.