📘
TEOS User Guides
Contact CoreLedgerPrivacy Policy
TEOS API
TEOS API
  • 👋Welcome to TEOS API
  • Get started
  • TEOS API overview
    • Terms and concepts
      • Asset
      • Spark
      • Wallet
      • Supply
      • Warp
      • Invoice
      • Transaction
    • Architecture note
      • Tenant setup options
    • Authentication
    • Versioning
  • Using TEOS API
    • Postman examples
    • Rate limits
    • Dealing with blockchain transactions
      • How to get Ether for signing transactions
      • Transaction creation and submission
        • First transaction creation and submission for a new address on the private blockchain
    • Handling errors
      • 1xxxx codes
      • 2xxxx codes
      • 3xxxx codes
    • TEOS Events
    • Warp search
  • TEOS API references
    • TEOS API Swagger (OpenAPI)
  • Using additional APIs of TEOS Platform
    • User authentication flow with TEOS Authentication service and TMS
    • Device authorization flow with TxServer and TEOS Authentication service
    • Adding wallet to the TEOS Platform flow with TxServer and TEOS API
    • Using TxServer API
      • TxServer API (OpenAPI)
      • Key Pair Generation. Transaction Signing
      • Device Restoration
    • Using TEOS Authentication service
      • TEOS Authentication Service API
    • Using TMS API
      • TMS API Swagger (OpenAPI)
      • Handling errors
      • Changelog
    • Using Discovery Service
  • FAQ
  • Changelog
    • v0.9
    • Non-versioned changes
    • Previous versions (not supported)
  • Troubleshooting
Powered by GitBook
On this page

Was this helpful?

Edit on GitHub
  1. TEOS API overview
  2. Terms and concepts

Warp

PreviousSupplyNextInvoice

Last updated 2 years ago

Was this helpful?

TEOS users can look for offers and execute the trades in order to get specific amount of sparks of desired asset in exchange to specific amount of sparks of offered asset using warp search and warp execution functionality. Warp is a chain of supplies that is automatically defined on-the-fly based on a mathematical optimization algorithm where the supplies, available in TEOS Platform at the moment, play the role of chain links.

Warp search is referred to a process of identifying possible chains of supplies based on the following criteria:

  • unique asset id of offered asset

  • unique asset id of desired asset

  • amount of sparks of desired asset to get OR amount of sparks of offered asset to pay - you can define only one of these parameters

Warp search results

Warp search results are the identified warps which meet given search criteria.

  • If the amount of sparks of offered asset to pay is set, search will result in

    • warps that allow you to get any amount of desired asset for the amount of sparks not more than amount of sparks of offered asset to pay

    • warps that allow you to get 1 spark of desired asset if you offered amount of sparks less than it is needed to get 1 spark of desired asset

  • If the amount of sparks of desired asset to get is set, search will result in

    • warps that allow you to get the amount of sparks of desired asset not less than amount of sparks of desired asset to get which was set

    • warps that allow you to get maximum available amount of sparks of desired asset if you desired amount of sparks more than it is available on the market

Found warps can be different by amount of offered and desired assets and exchange rate for trading them.

TEOS user can select the warp matching his goals the most and run warp execution. Before executing the selected warp TEOS will check that user has enough amount of sparks of offered asset to pay.

Learn how to implement it with TEOS API