GraphQLでクエリを実行する

概要

GraphQLインターフェースは、パースされたイベントのメソッドを両方公開しています。パースされたトランザクションをtransactionsを通じて、パースされたトランザクション履歴をtransactionsByAddressを通じて実行します。GraphQLの操作をPOST /v1/parsed-events/graphqlに送信します。これにより、クライアントが必要なフィールドだけを選択できるようにしつつ、RESTエンドポイントと同じパースされたトランザクションモデルが返されます。 GraphQLはフィールドが選択されている場合にのみrawTransactionを含みます。動的パーサーペイロードは、命令のデコード済みargs、トランザクション実行error、要約parsedData、およびrawTransactionを含むJSONスカラーのままです。

エンドポイント

GraphQLの操作をPOST /v1/parsed-events/graphqlに送信します。api-keyクエリパラメータで認証します。

JavaScript
cURL

const url = "https://mainnet.helius-rpc.com/v1/parsed-events/graphql?api-key=YOUR_API_KEY";

const response = await fetch(url, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    query: `query ParseTransactions($signatures: [String!]!) {
      transactions(signatures: $signatures, commitment: CONFIRMED) {
        signature
        parserStatus
      }
    }`,
    variables: {
      signatures: [
        "5xSKzM8bvpudE521jikHqASzMr23Ms4X4ieY3K8oFPFrJWCSSgYocJmHznrR8b12voDxKDH8ykdCLXSRrx6duVLH",
      ],
    },
  }),
});

const data = await response.json();
console.log(data);

curl -X POST "https://mainnet.helius-rpc.com/v1/parsed-events/graphql?api-key=YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "query": "query ParseTransactions($signatures: [String!]!) { transactions(signatures: $signatures, commitment: CONFIRMED) { signature parserStatus } }",
    "variables": {
      "signatures": ["5xSKzM8bvpudE521jikHqASzMr23Ms4X4ieY3K8oFPFrJWCSSgYocJmHznrR8b12voDxKDH8ykdCLXSRrx6duVLH"]
    }
  }'

トランザクションのパース

query ParseTransactions($signatures: [String!]!) {
  transactions(signatures: $signatures, commitment: CONFIRMED) {
    signature
    parserStatus
    parsed {
      slot
      blockTime
      fee
      feePayer
      transactionStatus
      nativeTransfers {
        fromUserAccount
        toUserAccount
        amount
      }
      tokenTransfers {
        fromUserAccount
        toUserAccount
        fromTokenAccount
        toTokenAccount
        rawTokenAmount
        decimals
        tokenStandard
        mint
      }
      summary {
        type
        description
        parsedData
      }
      instructions {
        instructionIndex
        innerInstructionIndex
        programId
        programName
        instructionName
        summary {
          type
          description
          parsedData
        }
        decoded {
          args
          accounts {
            name
            pubkey
            isSigner
            isWritable
          }
        }
      }
    }
    parserError {
      code
      message
    }
  }
}

変数:

{
  "signatures": ["5xSKzM8bvpudE521jikHqASzMr23Ms4X4ieY3K8oFPFrJWCSSgYocJmHznrR8b12voDxKDH8ykdCLXSRrx6duVLH"]
}

パースされたトランザクション履歴

query AddressHistory($address: String!) {
  transactionsByAddress(
    address: $address
    limit: 100
    sortOrder: DESC
    commitment: CONFIRMED
    filters: {
      slot: { gte: 300000000 }
    }
  ) {
    data {
      signature
      parserStatus
      parsed {
        slot
        blockTime
        nativeTransfers {
          fromUserAccount
          toUserAccount
          amount
        }
        tokenTransfers {
          fromUserAccount
          toUserAccount
          rawTokenAmount
          decimals
          mint
        }
      }
    }
    paginationToken
  }
}

変数:

{
  "address": "GV6UUmNxz2RpKxmNAPadYKb7uQpszwqQAu3qLJxVdC52"
}

クエリ引数

`transactions`

引数	タイプ	デフォルト	説明
`signatures`	`[String!]!`	-	パースするトランザクションの署名。
`commitment`	`Commitment`	`CONFIRMED`	`CONFIRMED` または `FINALIZED`。

`transactionsByAddress`

引数	タイプ	デフォルト	説明
`address`	`String!`	-	取引履歴を取得するアドレス。
`limit`	`Int`	`100`	返されるトランザクションの数。`1`と`100`の間である必要があります。
`beforeSignature`	`String`	-	この署名前のトランザクションを返します。
`afterSignature`	`String`	-	この署名後のトランザクションを返します。
`paginationToken`	`String`	-	カーソルの形状は`slot:transactionIndex`です。
`sortOrder`	`SortOrder`	`DESC`	`ASC`または`DESC`。
`commitment`	`Commitment`	`CONFIRMED`	`CONFIRMED`または`FINALIZED`。
`filters`	`AddressTransactionFiltersInput`	-	オプションの`slot`と`time`の境界。

生トランザクション

元のトランザクションJSONを含めるにはrawTransactionを選択します:

query ParseWithRaw($signatures: [String!]!) {
  transactions(signatures: $signatures) {
    signature
    rawTransaction
    parsed {
      slot
    }
  }
}

rawTransactionが選択されていない場合、サービスはそれを応答に含めません。

はじめに

データストリーミングとイベントリスニング

データAPIとRPC

トレーディング

トランザクションの送信

サービスとしてのウォレット

プライバシー

リソース

GraphQLでクエリを実行する

概要

エンドポイント

トランザクションのパース

パースされたトランザクション履歴

クエリ引数

`transactions`

`transactionsByAddress`

生トランザクション

​概要

​エンドポイント

​トランザクションのパース

​パースされたトランザクション履歴

​クエリ引数

​transactions

​transactionsByAddress

​生トランザクション

概要

エンドポイント

トランザクションのパース

パースされたトランザクション履歴

クエリ引数

`transactions`

`transactionsByAddress`

生トランザクション