feat: add CancelOrderByCloid method

Author: ignimbrite

hyperliquid/exchange_service.go

@@ -19,6 +19,7 @@ type IExchangeAPI interface {
 
 	// Order management
 	CancelOrderByOID(coin string, orderID int) (any, error)
+	CancelOrderByCloid(coin string, clientOID string) (any, error)
 	BulkCancelOrders(cancels []CancelOidWire) (any, error)
 	CancelAllOrdersByCoin(coin string) (any, error)
 	CancelAllOrders() (any, error)
@@ -310,6 +311,33 @@ func (api *ExchangeAPI) CancelOrderByOID(coin string, orderID int64) (*CancelOrd
 	return api.BulkCancelOrders([]CancelOidWire{{Asset: api.meta[coin].AssetId, Oid: int(orderID)}})
 }
 
+// Cancel exact order by Client Order Id
+// https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#cancel-order-s-by-cloid
+func (api *ExchangeAPI) CancelOrderByCloid(coin string, clientOID string) (*CancelOrderResponse, error) {
+	timestamp := GetNonce()
+	action := CancelCloidOrderAction{
+		Type: "cancelByCloid",
+		Cancels: []CancelCloidWire{
+			{
+				Asset: api.meta[coin].AssetId,
+				Cloid: clientOID,
+			},
+		},
+	}
+	v, r, s, err := api.SignL1Action(action, timestamp)
+	if err != nil {
+		api.debug("Error signing L1 action: %s", err)
+		return nil, err
+	}
+	request := ExchangeRequest{
+		Action:       action,
+		Nonce:        timestamp,
+		Signature:    ToTypedSig(r, s, v),
+		VaultAddress: nil,
+	}
+	return MakeUniversalRequest[CancelOrderResponse](api, request)
+}
+
 // Cancel all orders for a given coin
 func (api *ExchangeAPI) CancelAllOrdersByCoin(coin string) (*CancelOrderResponse, error) {
 	orders, err := api.infoAPI.GetOpenOrders(api.AccountAddress())

hyperliquid/exchange_types.go

@@ -146,6 +146,16 @@ type CancelOidWire struct {
 	Oid   int `msgpack:"o" json:"o"`
 }
 
+type CancelCloidWire struct {
+	Asset int    `msgpack:"asset" json:"asset"`
+	Cloid string `msgpack:"cloid" json:"cloid"`
+}
+
+type CancelCloidOrderAction struct {
+	Type    string            `msgpack:"type" json:"type"`
+	Cancels []CancelCloidWire `msgpack:"cancels" json:"cancels"`
+}
+
 type CancelOrderResponse struct {
 	Status   string              `json:"status"`
 	Response InnerCancelResponse `json:"response"`