Il riferimento completo delle API è pubblicato su openapi.intention-testnet.xyz e il sito per sviluppatori su dev.intention.xyz. In alcuni punti la forma dei payload è ancora in movimento, quindi per tutto ciò che sembra incoerente scrivere una email è più rapido che consultare la specifica.
Domande sull’uso delle API
Se stai integrando prima della pubblicazione del riferimento, scrivi acontact@intention.xyz con una descrizione in una riga di quello che stai costruendo e degli endpoint che prevedi di usare. Il team integrazioni può anticiparti com’è fatta al momento l’interfaccia e segnalarti tutto ciò che con ogni probabilità cambierà prima del lancio.
Quando sei già operativo su un endpoint e questo si comporta diversamente dalle attese, scrivi a contact@intention.xyz allegando il corpo della richiesta, il corpo della risposta, gli header rilevanti e l’orario UTC della chiamata. I ticket che citano il payload incriminato e la risposta osservata si risolvono di solito in un solo scambio, perché il team integrazioni può rieseguirli direttamente su staging.
Domande sugli interni del protocollo
Se stai cercando di capire perché il protocollo si comporta in un certo modo — semantica del matching, garanzie di sequenziamento, flusso delle commissioni, matematica del margine, certificazione dell’oracolo — parti dalla sezione architettura di questo sito. La pagina IntentionKernel copre l’esecuzione; IntentionBFT copre il consenso; la pagina Bridge copre depositi e prelievi. Se dopo averle lette ti resta una domanda di natura architetturale e non operativa, scrivi acontact@intention.xyz inquadrando in un paragrafo che cosa stai cercando di ricostruire e da quale pagina sei partito. Il team di protocollo smista queste domande e risponde direttamente oppure commissiona un miglioramento della documentazione, così il lettore successivo non dovrà più chiedere.
Integrazioni commerciali
Partnership, quotazioni, accordi di market making e qualunque cosa implichi un rapporto commerciale vanno acontact@intention.xyz. Includi una descrizione in una riga di quello che stai costruendo, di chi sei e di che cosa ti serve da Intention Labs perché funzioni. Un primo messaggio chiaro riduce moltissimo gli scambi successivi.
Segnalazioni di sicurezza
I problemi di sicurezza — tutto ciò che non vorresti finisse sotto gli occhi di uno sconosciuto su internet prima che esista una correzione — vanno acontact@intention.xyz con Security nell’oggetto, così vengono instradati prima della posta ordinaria. Le regole del programma sono sulla pagina Bug bounty. Leggila prima di inviare: seguire la procedura documentata è ciò che ti qualifica per la ricompensa.
Riepilogo
Tutto va a
contact@intention.xyz. Un primo messaggio chiaro riduce moltissimo gli scambi successivi.