diff --git a/clients/horizonclient/admin_client.go b/clients/horizonclient/admin_client.go new file mode 100644 index 0000000000..ffd389fc15 --- /dev/null +++ b/clients/horizonclient/admin_client.go @@ -0,0 +1,116 @@ +package horizonclient + +import ( + "bytes" + "context" + "encoding/json" + "fmt" + "net/http" + "net/url" + "time" + + hProtocol "github.com/stellar/go/protocols/horizon" + "github.com/stellar/go/support/errors" +) + +// port - the horizon admin port, zero value defaults to 4200 +// host - the host interface name that horizon has bound admin web service, zero value defaults to 'localhost' +// timeout - the length of time for the http client to wait on responses from admin web service +func NewAdminClient(port uint16, host string, timeout time.Duration) (*AdminClient, error) { + baseURL, err := getAdminBaseURL(port, host) + if err != nil { + return nil, err + } + if timeout == 0 { + timeout = HorizonTimeout + } + + return &AdminClient{ + baseURL: baseURL, + http: http.DefaultClient, + horizonTimeout: timeout, + }, nil +} + +func getAdminBaseURL(port uint16, host string) (string, error) { + baseURL, err := url.Parse("http://localhost") + if err != nil { + return "", err + } + adminPort := uint16(4200) + if port > 0 { + adminPort = port + } + adminHost := baseURL.Hostname() + if len(host) > 0 { + adminHost = host + } + baseURL.Host = fmt.Sprintf("%s:%d", adminHost, adminPort) + return baseURL.String(), nil +} + +func (c *AdminClient) sendGetRequest(requestURL string, a interface{}) error { + req, err := http.NewRequest("GET", requestURL, nil) + if err != nil { + return errors.Wrap(err, "error creating Admin HTTP request") + } + return c.sendHTTPRequest(req, a) +} + +func (c *AdminClient) sendHTTPRequest(req *http.Request, a interface{}) error { + ctx, cancel := context.WithTimeout(context.Background(), c.horizonTimeout) + defer cancel() + + if resp, err := c.http.Do(req.WithContext(ctx)); err != nil { + return err + } else { + return decodeResponse(resp, a, req.URL.String(), nil) + } +} + +func (c *AdminClient) getIngestionFiltersURL(filter string) string { + return fmt.Sprintf("%s/ingestion/filters/%s", c.baseURL, filter) +} + +func (c *AdminClient) GetIngestionAssetFilter() (hProtocol.AssetFilterConfig, error) { + var filter hProtocol.AssetFilterConfig + err := c.sendGetRequest(c.getIngestionFiltersURL("asset"), &filter) + return filter, err +} + +func (c *AdminClient) GetIngestionAccountFilter() (hProtocol.AccountFilterConfig, error) { + var filter hProtocol.AccountFilterConfig + err := c.sendGetRequest(c.getIngestionFiltersURL("account"), &filter) + return filter, err +} + +func (c *AdminClient) SetIngestionAssetFilter(filter hProtocol.AssetFilterConfig) error { + buf := bytes.NewBuffer(nil) + err := json.NewEncoder(buf).Encode(filter) + if err != nil { + return err + } + req, err := http.NewRequest(http.MethodPut, c.getIngestionFiltersURL("asset"), buf) + if err != nil { + return errors.Wrap(err, "error creating HTTP request") + } + req.Header.Add("Content-Type", "application/json") + return c.sendHTTPRequest(req, nil) +} + +func (c *AdminClient) SetIngestionAccountFilter(filter hProtocol.AccountFilterConfig) error { + buf := bytes.NewBuffer(nil) + err := json.NewEncoder(buf).Encode(filter) + if err != nil { + return err + } + req, err := http.NewRequest(http.MethodPut, c.getIngestionFiltersURL("account"), buf) + if err != nil { + return errors.Wrap(err, "error creating HTTP request") + } + req.Header.Add("Content-Type", "application/json") + return c.sendHTTPRequest(req, nil) +} + +// ensure that the horizon admin client implements AdminClientInterface +var _ AdminClientInterface = &AdminClient{} diff --git a/clients/horizonclient/admin_client_test.go b/clients/horizonclient/admin_client_test.go new file mode 100644 index 0000000000..83927a554b --- /dev/null +++ b/clients/horizonclient/admin_client_test.go @@ -0,0 +1,24 @@ +package horizonclient + +import ( + "testing" + + "github.com/stretchr/testify/assert" + "github.com/stretchr/testify/require" +) + +func TestDefaultAdminHostPort(t *testing.T) { + horizonAdminClient, err := NewAdminClient(0, "", 0) + + fullAdminURL := horizonAdminClient.getIngestionFiltersURL("test") + require.NoError(t, err) + assert.Equal(t, "http://localhost:4200/ingestion/filters/test", fullAdminURL) +} + +func TestOverrideAdminHostPort(t *testing.T) { + horizonAdminClient, err := NewAdminClient(1234, "127.0.0.1", 0) + + fullAdminURL := horizonAdminClient.getIngestionFiltersURL("test") + require.NoError(t, err) + assert.Equal(t, "http://127.0.0.1:1234/ingestion/filters/test", fullAdminURL) +} diff --git a/clients/horizonclient/client.go b/clients/horizonclient/client.go index c35f3267ca..e6b8d80df5 100644 --- a/clients/horizonclient/client.go +++ b/clients/horizonclient/client.go @@ -122,7 +122,7 @@ func (c *Client) sendHTTPRequest(req *http.Request, a interface{}) error { if resp, err := c.HTTP.Do(req.WithContext(ctx)); err != nil { return err } else { - return decodeResponse(resp, &a, c) + return decodeResponse(resp, a, c.HorizonURL, c.clock) } } @@ -270,6 +270,9 @@ func (c *Client) setDefaultClient() { // fixHorizonURL strips all slashes(/) at the end of HorizonURL if any, then adds a single slash func (c *Client) fixHorizonURL() string { c.fixHorizonURLOnce.Do(func() { + // TODO: we shouldn't happily edit data provided by the user, + // better store it in an internal variable or, even better, + // just parse it every time (what if the url changes during the life of the client?). c.HorizonURL = strings.TrimRight(c.HorizonURL, "/") + "/" }) return c.HorizonURL diff --git a/clients/horizonclient/internal.go b/clients/horizonclient/internal.go index 574b5b31ca..2133125550 100644 --- a/clients/horizonclient/internal.go +++ b/clients/horizonclient/internal.go @@ -8,19 +8,24 @@ import ( "strings" "time" + "github.com/stellar/go/support/clock" "github.com/stellar/go/support/errors" ) // decodeResponse decodes the response from a request to a horizon server -func decodeResponse(resp *http.Response, object interface{}, hc *Client) (err error) { +func decodeResponse(resp *http.Response, object interface{}, horizonUrl string, clock *clock.Clock) (err error) { defer resp.Body.Close() + if object == nil { + // Nothing to decode + return nil + } decoder := json.NewDecoder(resp.Body) - u, err := url.Parse(hc.HorizonURL) + u, err := url.Parse(horizonUrl) if err != nil { - return errors.Errorf("unable to parse the provided horizon url: %s", hc.HorizonURL) + return errors.Errorf("unable to parse the provided horizon url: %s", horizonUrl) } - setCurrentServerTime(u.Hostname(), resp.Header["Date"], hc) + setCurrentServerTime(u.Hostname(), resp.Header["Date"], clock) if !(resp.StatusCode >= 200 && resp.StatusCode < 300) { horizonError := &Error{ @@ -32,7 +37,6 @@ func decodeResponse(resp *http.Response, object interface{}, hc *Client) (err er } return horizonError } - err = decoder.Decode(&object) if err != nil { return errors.Wrap(err, "error decoding response") @@ -120,7 +124,7 @@ func addQueryParams(params ...interface{}) string { } // setCurrentServerTime saves the current time returned by a horizon server -func setCurrentServerTime(host string, serverDate []string, hc *Client) { +func setCurrentServerTime(host string, serverDate []string, clock *clock.Clock) { if len(serverDate) == 0 { return } @@ -129,7 +133,7 @@ func setCurrentServerTime(host string, serverDate []string, hc *Client) { return } serverTimeMapMutex.Lock() - ServerTimeMap[host] = ServerTimeRecord{ServerTime: st.UTC().Unix(), LocalTimeRecorded: hc.clock.Now().UTC().Unix()} + ServerTimeMap[host] = ServerTimeRecord{ServerTime: st.UTC().Unix(), LocalTimeRecorded: clock.Now().UTC().Unix()} serverTimeMapMutex.Unlock() } diff --git a/clients/horizonclient/main.go b/clients/horizonclient/main.go index d85954e922..8eb7bdc606 100644 --- a/clients/horizonclient/main.go +++ b/clients/horizonclient/main.go @@ -149,11 +149,29 @@ type Client struct { clock *clock.Clock } +type AdminClient struct { + // fully qualified url for the admin web service + baseURL string + + // HTTP client to make requests with + http HTTP + + // max client wait time for response + horizonTimeout time.Duration +} + // SubmitTxOpts represents the submit transaction options type SubmitTxOpts struct { SkipMemoRequiredCheck bool } +type AdminClientInterface interface { + GetIngestionAccountFilter() (hProtocol.AccountFilterConfig, error) + GetIngestionAssetFilter() (hProtocol.AssetFilterConfig, error) + SetIngestionAccountFilter(hProtocol.AccountFilterConfig) error + SetIngestionAssetFilter(hProtocol.AssetFilterConfig) error +} + // ClientInterface contains methods implemented by the horizon client type ClientInterface interface { Accounts(request AccountsRequest) (hProtocol.AccountsPage, error) diff --git a/clients/horizonclient/mocks.go b/clients/horizonclient/mocks.go index b65e9739a9..fbf6fe5b66 100644 --- a/clients/horizonclient/mocks.go +++ b/clients/horizonclient/mocks.go @@ -15,6 +15,10 @@ type MockClient struct { mock.Mock } +type MockAdminClient struct { + mock.Mock +} + // Accounts is a mocking method func (m *MockClient) Accounts(request AccountsRequest) (hProtocol.AccountsPage, error) { a := m.Called(request) @@ -349,5 +353,28 @@ func (m *MockClient) PrevLiquidityPoolsPage(page hProtocol.LiquidityPoolsPage) ( return a.Get(0).(hProtocol.LiquidityPoolsPage), a.Error(1) } +func (m *MockAdminClient) GetIngestionAccountFilter() (hProtocol.AccountFilterConfig, error) { + a := m.Called() + return a.Get(0).(hProtocol.AccountFilterConfig), a.Error(1) +} + +func (m *MockAdminClient) GetIngestionAssetFilter() (hProtocol.AssetFilterConfig, error) { + a := m.Called() + return a.Get(0).(hProtocol.AssetFilterConfig), a.Error(1) +} + +func (m *MockAdminClient) SetIngestionAccountFilter(resource hProtocol.AccountFilterConfig) error { + a := m.Called(resource) + return a.Error(0) +} + +func (m *MockAdminClient) SetIngestionAssetFilter(resource hProtocol.AssetFilterConfig) error { + a := m.Called(resource) + return a.Error(0) +} + // ensure that the MockClient implements ClientInterface var _ ClientInterface = &MockClient{} + +// ensure that the MockClient implements ClientInterface +var _ AdminClientInterface = &MockAdminClient{} diff --git a/protocols/horizon/main.go b/protocols/horizon/main.go index 2b99a5e068..8c5635860a 100644 --- a/protocols/horizon/main.go +++ b/protocols/horizon/main.go @@ -843,3 +843,55 @@ type LiquidityPoolReserve struct { Asset string `json:"asset"` Amount string `json:"amount"` } + +type AssetFilterConfig struct { + Whitelist []string `json:"whitelist"` + Enabled *bool `json:"enabled"` + LastModified int64 `json:"last_modified,omitempty"` +} + +type AccountFilterConfig struct { + Whitelist []string `json:"whitelist"` + Enabled *bool `json:"enabled"` + LastModified int64 `json:"last_modified,omitempty"` +} + +func (f *AccountFilterConfig) UnmarshalJSON(data []byte) error { + type accountFilterConfig AccountFilterConfig + var config = accountFilterConfig{} + + if err := json.Unmarshal(data, &config); err != nil { + return err + } + + if config.Whitelist == nil { + return errors.New("missing required whitelist") + } + + if config.Enabled == nil { + return errors.New("missing required enabled") + } + + *f = AccountFilterConfig(config) + return nil +} + +func (f *AssetFilterConfig) UnmarshalJSON(data []byte) error { + type assetFilterConfig AssetFilterConfig + var config = assetFilterConfig{} + + if err := json.Unmarshal(data, &config); err != nil { + return err + } + + if config.Whitelist == nil { + return errors.New("missing required whitelist") + } + + if config.Enabled == nil { + return errors.New("missing required enabled") + } + + *f = AssetFilterConfig(config) + return nil +} diff --git a/services/horizon/CHANGELOG.md b/services/horizon/CHANGELOG.md index a43b8ea64f..431a33f40c 100644 --- a/services/horizon/CHANGELOG.md +++ b/services/horizon/CHANGELOG.md @@ -13,6 +13,19 @@ This is the final release after the [release candidate](v2.17.0-release-candidat - Timebounds within the `preconditions` object are strings containing int64 UNIX timestamps in seconds rather than formatted date-times (which was a bug) ([4361](https://github.com/stellar/go/pull/4361)). +* New Ingestion Filters Feature: Provide the ability to select which ledger transactions are accepted at ingestion time to be stored on horizon's historical databse. + + Define filter rules through Admin API and the historical ingestion process will check the rules and only persist the ledger transactions that pass the filter rules. Initially, two filters and corresponding rules are possible: + + * 'whitelist by account id' ([4221](https://github.com/stellar/go/issues/4221)) + * 'whitelist by canonical asset id' ([4222](https://github.com/stellar/go/issues/4222)) + + The filters and their configuration are optional features and must be enabled with horizon command line parameters `admin-port=4200` and `enable-ingestion-filtering=true` + + Once set, filter configurations and their rules are initially empty and the filters are disabled by default. To enable filters, update the configuration settings, refer to the Admin API Docs which are published on the Admin Port at http://localhost:/, follow details and examples for endpoints: + * `/ingestion/filters/account` + * `/ingestion/filters/asset.` + ## V2.17.0 Release Candidate **Upgrading to this version from <= v2.8.3 will trigger a state rebuild. During this process (which will take at least 10 minutes), Horizon will not ingest new ledgers.** diff --git a/services/horizon/cmd/db.go b/services/horizon/cmd/db.go index 819a6b3cbe..81b3f56600 100644 --- a/services/horizon/cmd/db.go +++ b/services/horizon/cmd/db.go @@ -384,6 +384,7 @@ func runDBReingestRange(ledgerRanges []history.LedgerRange, reingestForce bool, NetworkPassphrase: config.NetworkPassphrase, HistoryArchiveURL: config.HistoryArchiveURLs[0], CheckpointFrequency: config.CheckpointFrequency, + ReingestEnabled: true, MaxReingestRetries: int(retries), ReingestRetryBackoffSeconds: int(retryBackoffSeconds), EnableCaptiveCore: config.EnableCaptiveCoreIngestion, @@ -395,6 +396,7 @@ func runDBReingestRange(ledgerRanges []history.LedgerRange, reingestForce bool, StellarCoreCursor: config.CursorName, StellarCoreURL: config.StellarCoreURL, RoundingSlippageFilter: config.RoundingSlippageFilter, + EnableIngestionFiltering: config.EnableIngestionFiltering, } if ingestConfig.HistorySession, err = db.Open("postgres", config.DatabaseURL); err != nil { diff --git a/services/horizon/cmd/ingest.go b/services/horizon/cmd/ingest.go index 7cff13f3df..fa7d712153 100644 --- a/services/horizon/cmd/ingest.go +++ b/services/horizon/cmd/ingest.go @@ -104,17 +104,18 @@ var ingestVerifyRangeCmd = &cobra.Command{ } ingestConfig := ingest.Config{ - NetworkPassphrase: config.NetworkPassphrase, - HistorySession: horizonSession, - HistoryArchiveURL: config.HistoryArchiveURLs[0], - EnableCaptiveCore: config.EnableCaptiveCoreIngestion, - CaptiveCoreBinaryPath: config.CaptiveCoreBinaryPath, - CaptiveCoreConfigUseDB: config.CaptiveCoreConfigUseDB, - RemoteCaptiveCoreURL: config.RemoteCaptiveCoreURL, - CheckpointFrequency: config.CheckpointFrequency, - CaptiveCoreToml: config.CaptiveCoreToml, - CaptiveCoreStoragePath: config.CaptiveCoreStoragePath, - RoundingSlippageFilter: config.RoundingSlippageFilter, + NetworkPassphrase: config.NetworkPassphrase, + HistorySession: horizonSession, + HistoryArchiveURL: config.HistoryArchiveURLs[0], + EnableCaptiveCore: config.EnableCaptiveCoreIngestion, + CaptiveCoreBinaryPath: config.CaptiveCoreBinaryPath, + CaptiveCoreConfigUseDB: config.CaptiveCoreConfigUseDB, + RemoteCaptiveCoreURL: config.RemoteCaptiveCoreURL, + CheckpointFrequency: config.CheckpointFrequency, + CaptiveCoreToml: config.CaptiveCoreToml, + CaptiveCoreStoragePath: config.CaptiveCoreStoragePath, + RoundingSlippageFilter: config.RoundingSlippageFilter, + EnableIngestionFiltering: config.EnableIngestionFiltering, } if !ingestConfig.EnableCaptiveCore { @@ -290,12 +291,13 @@ var ingestInitGenesisStateCmd = &cobra.Command{ } ingestConfig := ingest.Config{ - NetworkPassphrase: config.NetworkPassphrase, - HistorySession: horizonSession, - HistoryArchiveURL: config.HistoryArchiveURLs[0], - EnableCaptiveCore: config.EnableCaptiveCoreIngestion, - CheckpointFrequency: config.CheckpointFrequency, - RoundingSlippageFilter: config.RoundingSlippageFilter, + NetworkPassphrase: config.NetworkPassphrase, + HistorySession: horizonSession, + HistoryArchiveURL: config.HistoryArchiveURLs[0], + EnableCaptiveCore: config.EnableCaptiveCoreIngestion, + CheckpointFrequency: config.CheckpointFrequency, + RoundingSlippageFilter: config.RoundingSlippageFilter, + EnableIngestionFiltering: config.EnableIngestionFiltering, } if config.EnableCaptiveCoreIngestion { diff --git a/services/horizon/internal/actions/filter_rules.go b/services/horizon/internal/actions/filter_rules.go new file mode 100644 index 0000000000..274f802965 --- /dev/null +++ b/services/horizon/internal/actions/filter_rules.go @@ -0,0 +1,151 @@ +package actions + +import ( + "encoding/json" + "fmt" + "net/http" + + hProtocol "github.com/stellar/go/protocols/horizon" + horizonContext "github.com/stellar/go/services/horizon/internal/context" + "github.com/stellar/go/services/horizon/internal/db2/history" + "github.com/stellar/go/support/render/problem" +) + +// these admin HTTP endpoints are documented in services/horizon/internal/httpx/static/admin_oapi.yml +type FilterConfigHandler struct{} + +func (handler FilterConfigHandler) GetAssetConfig(w http.ResponseWriter, r *http.Request) { + historyQ, err := horizonContext.HistoryQFromRequest(r) + if err != nil { + problem.Render(r.Context(), w, err) + return + } + + config, err := historyQ.GetAssetFilterConfig(r.Context()) + + if err != nil { + problem.Render(r.Context(), w, err) + return + } + + responsePayload := handler.assetConfigResource(config) + enc := json.NewEncoder(w) + if err = enc.Encode(responsePayload); err != nil { + problem.Render(r.Context(), w, err) + } +} + +func (handler FilterConfigHandler) GetAccountConfig(w http.ResponseWriter, r *http.Request) { + historyQ, err := horizonContext.HistoryQFromRequest(r) + if err != nil { + problem.Render(r.Context(), w, err) + return + } + + config, err := historyQ.GetAccountFilterConfig(r.Context()) + + if err != nil { + problem.Render(r.Context(), w, err) + return + } + + responsePayload := handler.accountConfigResource(config) + enc := json.NewEncoder(w) + if err = enc.Encode(responsePayload); err != nil { + problem.Render(r.Context(), w, err) + } +} + +func (handler FilterConfigHandler) UpdateAccountConfig(w http.ResponseWriter, r *http.Request) { + historyQ, err := horizonContext.HistoryQFromRequest(r) + if err != nil { + problem.Render(r.Context(), w, err) + return + } + + filterRequest, err := handler.accountFilterResource(r) + if err != nil { + problem.Render(r.Context(), w, err) + return + } + + filterConfig := history.AccountFilterConfig{} + filterConfig.Enabled = *filterRequest.Enabled + filterConfig.Whitelist = filterRequest.Whitelist + + config, err := historyQ.UpdateAccountFilterConfig(r.Context(), filterConfig) + if err != nil { + problem.Render(r.Context(), w, err) + } + + responsePayload := handler.accountConfigResource(config) + enc := json.NewEncoder(w) + if err = enc.Encode(responsePayload); err != nil { + problem.Render(r.Context(), w, err) + } +} + +func (handler FilterConfigHandler) UpdateAssetConfig(w http.ResponseWriter, r *http.Request) { + historyQ, err := horizonContext.HistoryQFromRequest(r) + if err != nil { + problem.Render(r.Context(), w, err) + return + } + + filterRequest, err := handler.assetFilterResource(r) + if err != nil { + problem.Render(r.Context(), w, err) + return + } + + filterConfig := history.AssetFilterConfig{} + filterConfig.Enabled = *filterRequest.Enabled + filterConfig.Whitelist = filterRequest.Whitelist + + config, err := historyQ.UpdateAssetFilterConfig(r.Context(), filterConfig) + if err != nil { + problem.Render(r.Context(), w, err) + } + + responsePayload := handler.assetConfigResource(config) + enc := json.NewEncoder(w) + if err = enc.Encode(responsePayload); err != nil { + problem.Render(r.Context(), w, err) + } +} + +func (handler FilterConfigHandler) assetFilterResource(r *http.Request) (hProtocol.AssetFilterConfig, error) { + var filterRequest hProtocol.AssetFilterConfig + dec := json.NewDecoder(r.Body) + if err := dec.Decode(&filterRequest); err != nil { + p := problem.NewProblemWithInvalidField(problem.BadRequest, "reason", fmt.Errorf("invalid json for asset filter config %v", err.Error())) + return hProtocol.AssetFilterConfig{}, p + } + return filterRequest, nil +} + +func (handler FilterConfigHandler) accountFilterResource(r *http.Request) (hProtocol.AccountFilterConfig, error) { + var filterRequest hProtocol.AccountFilterConfig + dec := json.NewDecoder(r.Body) + if err := dec.Decode(&filterRequest); err != nil { + p := problem.NewProblemWithInvalidField(problem.BadRequest, "reason", fmt.Errorf("invalid json for account filter config %v", err.Error())) + return hProtocol.AccountFilterConfig{}, p + } + return filterRequest, nil +} + +func (handler FilterConfigHandler) assetConfigResource(config history.AssetFilterConfig) hProtocol.AssetFilterConfig { + return hProtocol.AssetFilterConfig{ + Whitelist: config.Whitelist, + Enabled: &config.Enabled, + LastModified: config.LastModified, + } +} + +func (handler FilterConfigHandler) accountConfigResource(config history.AccountFilterConfig) hProtocol.AccountFilterConfig { + return hProtocol.AccountFilterConfig{ + Whitelist: config.Whitelist, + Enabled: &config.Enabled, + LastModified: config.LastModified, + } +} diff --git a/services/horizon/internal/actions/filter_rules_test.go b/services/horizon/internal/actions/filter_rules_test.go new file mode 100644 index 0000000000..9da19a61f4 --- /dev/null +++ b/services/horizon/internal/actions/filter_rules_test.go @@ -0,0 +1,246 @@ +package actions + +import ( + "encoding/json" + "io/ioutil" + "net/http" + "net/http/httptest" + "strings" + "testing" + + hProtocol "github.com/stellar/go/protocols/horizon" + "github.com/stellar/go/services/horizon/internal/db2/history" + "github.com/stellar/go/services/horizon/internal/test" +) + +func TestGetAssetFilterConfig(t *testing.T) { + tt := test.Start(t) + defer tt.Finish() + test.ResetHorizonDB(t, tt.HorizonDB) + + q := &history.Q{SessionInterface: tt.HorizonSession()} + + // put some more values into the config for resource validation after retrieval + fc1 := history.AssetFilterConfig{ + Whitelist: []string{"1", "2"}, + Enabled: true, + } + + q.UpdateAssetFilterConfig(tt.Ctx, fc1) + + handler := &FilterConfigHandler{} + recorder := httptest.NewRecorder() + handler.GetAssetConfig( + recorder, + makeRequest( + t, + map[string]string{}, + map[string]string{}, + q, + ), + ) + + resp := recorder.Result() + tt.Assert.Equal(http.StatusOK, resp.StatusCode) + + raw, err := ioutil.ReadAll(resp.Body) + tt.Assert.NoError(err) + + var filterCfgResource hProtocol.AssetFilterConfig + json.Unmarshal(raw, &filterCfgResource) + tt.Assert.NoError(err) + + tt.Assert.ElementsMatch(filterCfgResource.Whitelist, []string{"1", "2"}) + tt.Assert.Equal(*filterCfgResource.Enabled, true) + tt.Assert.True(filterCfgResource.LastModified > 0) +} + +func TestGetAccountFilterConfig(t *testing.T) { + tt := test.Start(t) + defer tt.Finish() + test.ResetHorizonDB(t, tt.HorizonDB) + + q := &history.Q{SessionInterface: tt.HorizonSession()} + + // put some more values into the config for resource validation after retrieval + fc1 := history.AccountFilterConfig{ + Whitelist: []string{"1", "2"}, + Enabled: true, + } + + q.UpdateAccountFilterConfig(tt.Ctx, fc1) + + handler := &FilterConfigHandler{} + recorder := httptest.NewRecorder() + handler.GetAccountConfig( + recorder, + makeRequest( + t, + map[string]string{}, + map[string]string{}, + q, + ), + ) + + resp := recorder.Result() + tt.Assert.Equal(http.StatusOK, resp.StatusCode) + + raw, err := ioutil.ReadAll(resp.Body) + tt.Assert.NoError(err) + + var filterCfgResource hProtocol.AccountFilterConfig + json.Unmarshal(raw, &filterCfgResource) + tt.Assert.NoError(err) + + tt.Assert.ElementsMatch(filterCfgResource.Whitelist, []string{"1", "2"}) + tt.Assert.Equal(*filterCfgResource.Enabled, true) + tt.Assert.True(filterCfgResource.LastModified > 0) +} + +func TestMalFormedUpdateAssetFilterConfig(t *testing.T) { + tt := test.Start(t) + defer tt.Finish() + test.ResetHorizonDB(t, tt.HorizonDB) + + q := &history.Q{SessionInterface: tt.HorizonSession()} + + handler := &FilterConfigHandler{} + recorder := httptest.NewRecorder() + request := makeRequest( + t, + map[string]string{}, + map[string]string{}, + q, + ) + + request.Body = ioutil.NopCloser(strings.NewReader(` + { + "enabled": true + } + `)) + + handler.UpdateAssetConfig( + recorder, + request, + ) + + resp := recorder.Result() + // can't update a filter when it's missing a required filed, Whitelist + tt.Assert.Equal(http.StatusBadRequest, resp.StatusCode) +} + +func TestMalFormedUpdateAccountFilterConfig(t *testing.T) { + tt := test.Start(t) + defer tt.Finish() + test.ResetHorizonDB(t, tt.HorizonDB) + + q := &history.Q{SessionInterface: tt.HorizonSession()} + + handler := &FilterConfigHandler{} + recorder := httptest.NewRecorder() + request := makeRequest( + t, + map[string]string{}, + map[string]string{}, + q, + ) + + request.Body = ioutil.NopCloser(strings.NewReader(` + { + "enabled": true + } + `)) + + handler.UpdateAccountConfig( + recorder, + request, + ) + + resp := recorder.Result() + // can't update a filter when it's missing a required filed, Whitelist + tt.Assert.Equal(http.StatusBadRequest, resp.StatusCode) +} + +func TestUpdateAssetFilterConfig(t *testing.T) { + tt := test.Start(t) + defer tt.Finish() + test.ResetHorizonDB(t, tt.HorizonDB) + + q := &history.Q{SessionInterface: tt.HorizonSession()} + + handler := &FilterConfigHandler{} + recorder := httptest.NewRecorder() + request := makeRequest( + t, + map[string]string{}, + map[string]string{}, + q, + ) + + request.Body = ioutil.NopCloser(strings.NewReader(` + { + "whitelist": ["4","5","6"], + "enabled": true + }`)) + + handler.UpdateAssetConfig( + recorder, + request, + ) + + resp := recorder.Result() + tt.Assert.Equal(http.StatusOK, resp.StatusCode) + + raw, err := ioutil.ReadAll(resp.Body) + tt.Assert.NoError(err) + + var filterCfgResource hProtocol.AssetFilterConfig + json.Unmarshal(raw, &filterCfgResource) + tt.Assert.NoError(err) + + tt.Assert.Equal(*filterCfgResource.Enabled, true) + tt.Assert.True(filterCfgResource.LastModified > 0) + tt.Assert.ElementsMatch(filterCfgResource.Whitelist, []string{"4", "5", "6"}) +} + +func TestUpdateAccountFilterConfig(t *testing.T) { + tt := test.Start(t) + defer tt.Finish() + test.ResetHorizonDB(t, tt.HorizonDB) + + q := &history.Q{SessionInterface: tt.HorizonSession()} + + handler := &FilterConfigHandler{} + recorder := httptest.NewRecorder() + request := makeRequest( + t, + map[string]string{}, + map[string]string{}, + q, + ) + + request.Body = ioutil.NopCloser(strings.NewReader(` + { + "whitelist": ["4","5","6"], + "enabled": true + }`)) + + handler.UpdateAccountConfig( + recorder, + request, + ) + + resp := recorder.Result() + tt.Assert.Equal(http.StatusOK, resp.StatusCode) + + raw, err := ioutil.ReadAll(resp.Body) + tt.Assert.NoError(err) + + var filterCfgResource hProtocol.AccountFilterConfig + json.Unmarshal(raw, &filterCfgResource) + tt.Assert.NoError(err) + + tt.Assert.Equal(*filterCfgResource.Enabled, true) + tt.Assert.True(filterCfgResource.LastModified > 0) + tt.Assert.ElementsMatch(filterCfgResource.Whitelist, []string{"4", "5", "6"}) +} diff --git a/services/horizon/internal/actions/submit_transaction.go b/services/horizon/internal/actions/submit_transaction.go index 703412c801..a91a7aea53 100644 --- a/services/horizon/internal/actions/submit_transaction.go +++ b/services/horizon/internal/actions/submit_transaction.go @@ -18,11 +18,7 @@ import ( ) type NetworkSubmitter interface { - Submit( - ctx context.Context, - rawTx string, - envelope xdr.TransactionEnvelope, - hash string) <-chan txsub.Result + Submit(ctx context.Context, rawTx string, envelope xdr.TransactionEnvelope, hash string, innerHash string) <-chan txsub.Result } type SubmitTransactionHandler struct { @@ -32,9 +28,10 @@ type SubmitTransactionHandler struct { } type envelopeInfo struct { - hash string - raw string - parsed xdr.TransactionEnvelope + hash string + innerHash string + raw string + parsed xdr.TransactionEnvelope } func extractEnvelopeInfo(raw string, passphrase string) (envelopeInfo, error) { @@ -50,6 +47,13 @@ func extractEnvelopeInfo(raw string, passphrase string) (envelopeInfo, error) { return result, err } result.hash = hex.EncodeToString(hash[:]) + if result.parsed.IsFeeBump() { + hash, err = network.HashTransaction(result.parsed.FeeBump.Tx.InnerTx.V1.Tx, passphrase) + if err != nil { + return result, err + } + result.innerHash = hex.EncodeToString(hash[:]) + } return result, nil } @@ -151,12 +155,7 @@ func (handler SubmitTransactionHandler) GetResource(w HeaderWriter, r *http.Requ return nil, hProblem.StaleHistory } - submission := handler.Submitter.Submit( - r.Context(), - info.raw, - info.parsed, - info.hash, - ) + submission := handler.Submitter.Submit(r.Context(), info.raw, info.parsed, info.hash, info.innerHash) select { case result := <-submission: diff --git a/services/horizon/internal/actions/submit_transaction_test.go b/services/horizon/internal/actions/submit_transaction_test.go index 72ccb5a297..8a42c6e97f 100644 --- a/services/horizon/internal/actions/submit_transaction_test.go +++ b/services/horizon/internal/actions/submit_transaction_test.go @@ -44,11 +44,7 @@ type networkSubmitterMock struct { mock.Mock } -func (m *networkSubmitterMock) Submit( - ctx context.Context, - rawTx string, - envelope xdr.TransactionEnvelope, - hash string) <-chan txsub.Result { +func (m *networkSubmitterMock) Submit(ctx context.Context, rawTx string, envelope xdr.TransactionEnvelope, hash string, innerHash string) <-chan txsub.Result { a := m.Called() return a.Get(0).(chan txsub.Result) } diff --git a/services/horizon/internal/app.go b/services/horizon/internal/app.go index 831f524dcc..343df9b085 100644 --- a/services/horizon/internal/app.go +++ b/services/horizon/internal/app.go @@ -535,6 +535,7 @@ func (a *App) init() error { }, cache: newHealthCache(healthCacheTTL), }, + EnableIngestionFiltering: a.config.EnableIngestionFiltering, } if a.primaryHistoryQ != nil { diff --git a/services/horizon/internal/config.go b/services/horizon/internal/config.go index 888acae0cd..4dcf3a2667 100644 --- a/services/horizon/internal/config.go +++ b/services/horizon/internal/config.go @@ -20,6 +20,7 @@ type Config struct { AdminPort uint EnableCaptiveCoreIngestion bool + EnableIngestionFiltering bool UsingDefaultPubnetConfig bool CaptiveCoreBinaryPath string RemoteCaptiveCoreURL string diff --git a/services/horizon/internal/db2/history/fee_bump_scenario.go b/services/horizon/internal/db2/history/fee_bump_scenario.go index b555aa9355..8f488b03d3 100644 --- a/services/horizon/internal/db2/history/fee_bump_scenario.go +++ b/services/horizon/internal/db2/history/fee_bump_scenario.go @@ -254,6 +254,12 @@ func FeeBumpScenario(tt *test.T, q *Q, successful bool) FeeBumpFixture { tt.Assert.NoError(insertBuilder.Add(ctx, normalTransaction, sequence)) tt.Assert.NoError(insertBuilder.Exec(ctx)) + tt.Assert.NoError(q.InitEmptyTxSubmissionResult(ctx, hex.EncodeToString(normalTransaction.Result.TransactionHash[:]), "")) + tt.Assert.NoError(q.InitEmptyTxSubmissionResult(ctx, fixture.OuterHash, fixture.InnerHash)) + txs := []ingest.LedgerTransaction{normalTransaction, feeBumpTransaction} + affectedRows, err := q.SetTxSubmissionResults(ctx, txs, uint32(fixture.Ledger.Sequence), fixture.Ledger.ClosedAt) + tt.Assert.NoError(err) + tt.Assert.Equal(int64(2), affectedRows) account := fixture.Envelope.SourceAccount().ToAccountId() feeBumpAccount := fixture.Envelope.FeeBumpAccount().ToAccountId() diff --git a/services/horizon/internal/db2/history/filter_rules.go b/services/horizon/internal/db2/history/filter_rules.go new file mode 100644 index 0000000000..4ac341bc13 --- /dev/null +++ b/services/horizon/internal/db2/history/filter_rules.go @@ -0,0 +1,100 @@ +package history + +import ( + "context" + "database/sql" + + sq "github.com/Masterminds/squirrel" + "github.com/lib/pq" +) + +const ( + assetFilterRulesTableName = "asset_filter_rules" + accountFilterRulesTableName = "account_filter_rules" + whitelistColumnName = "whitelist" + enabledColumnName = "enabled" + lastModifiedColumnName = "last_modified" +) + +type AssetFilterConfig struct { + Enabled bool `db:"enabled"` + Whitelist pq.StringArray `db:"whitelist"` + LastModified int64 `db:"last_modified"` +} + +type AccountFilterConfig struct { + Enabled bool `db:"enabled"` + Whitelist pq.StringArray `db:"whitelist"` + LastModified int64 `db:"last_modified"` +} + +type QFilter interface { + GetAccountFilterConfig(ctx context.Context) (AccountFilterConfig, error) + GetAssetFilterConfig(ctx context.Context) (AssetFilterConfig, error) + UpdateAssetFilterConfig(ctx context.Context, config AssetFilterConfig) (AssetFilterConfig, error) + UpdateAccountFilterConfig(ctx context.Context, config AccountFilterConfig) (AccountFilterConfig, error) +} + +func (q *Q) GetAccountFilterConfig(ctx context.Context) (AccountFilterConfig, error) { + filterConfig := AccountFilterConfig{} + sql := sq.Select("*").From(accountFilterRulesTableName) + err := q.Get(ctx, &filterConfig, sql) + + return filterConfig, err +} + +func (q *Q) GetAssetFilterConfig(ctx context.Context) (AssetFilterConfig, error) { + filterConfig := AssetFilterConfig{} + sql := sq.Select("*").From(assetFilterRulesTableName) + err := q.Get(ctx, &filterConfig, sql) + + return filterConfig, err +} + +func (q *Q) UpdateAssetFilterConfig(ctx context.Context, config AssetFilterConfig) (AssetFilterConfig, error) { + updateCols := map[string]interface{}{ + lastModifiedColumnName: sq.Expr(`extract(epoch from now() at time zone 'utc')`), + enabledColumnName: config.Enabled, + whitelistColumnName: config.Whitelist, + } + + sqlUpdate := sq.Update(assetFilterRulesTableName).SetMap(updateCols) + + rowCnt, err := q.checkForError(sqlUpdate, ctx) + if err != nil { + return AssetFilterConfig{}, err + } + + if rowCnt < 1 { + return AssetFilterConfig{}, sql.ErrNoRows + } + return q.GetAssetFilterConfig(ctx) +} + +func (q *Q) UpdateAccountFilterConfig(ctx context.Context, config AccountFilterConfig) (AccountFilterConfig, error) { + updateCols := map[string]interface{}{ + lastModifiedColumnName: sq.Expr(`extract(epoch from now() at time zone 'utc')`), + enabledColumnName: config.Enabled, + whitelistColumnName: config.Whitelist, + } + + sqlUpdate := sq.Update(accountFilterRulesTableName).SetMap(updateCols) + + rowCnt, err := q.checkForError(sqlUpdate, ctx) + if err != nil { + return AccountFilterConfig{}, err + } + + if rowCnt < 1 { + return AccountFilterConfig{}, sql.ErrNoRows + } + return q.GetAccountFilterConfig(ctx) +} + +func (q *Q) checkForError(builder sq.Sqlizer, ctx context.Context) (int64, error) { + result, err := q.Exec(ctx, builder) + if err != nil { + return 0, err + } + return result.RowsAffected() +} diff --git a/services/horizon/internal/db2/history/filter_rules_test.go b/services/horizon/internal/db2/history/filter_rules_test.go new file mode 100644 index 0000000000..f48b4cbad6 --- /dev/null +++ b/services/horizon/internal/db2/history/filter_rules_test.go @@ -0,0 +1,45 @@ +package history + +import ( + "testing" + + "github.com/stellar/go/services/horizon/internal/test" + "github.com/stretchr/testify/assert" +) + +func TestAssetFilterConfig(t *testing.T) { + tt := test.Start(t) + defer tt.Finish() + test.ResetHorizonDB(t, tt.HorizonDB) + q := &Q{tt.HorizonSession()} + + fc1Result, err := q.GetAssetFilterConfig(tt.Ctx) + assert.NoError(t, err) + tt.Assert.Equal(fc1Result.Enabled, false) + tt.Assert.Len(fc1Result.Whitelist, 0) + + fc1Result.Enabled = true + fc1Result.Whitelist = append(fc1Result.Whitelist, "1", "2") + fc1Result, err = q.UpdateAssetFilterConfig(tt.Ctx, fc1Result) + assert.NoError(t, err) + tt.Assert.Equal(fc1Result.Enabled, true) + tt.Assert.ElementsMatch(fc1Result.Whitelist, []string{"1", "2"}) +} + +func TestAccountFilterConfig(t *testing.T) { + tt := test.Start(t) + defer tt.Finish() + test.ResetHorizonDB(t, tt.HorizonDB) + q := &Q{tt.HorizonSession()} + + fc1Result, err := q.GetAccountFilterConfig(tt.Ctx) + assert.NoError(t, err) + tt.Assert.Equal(fc1Result.Enabled, false) + tt.Assert.Len(fc1Result.Whitelist, 0) + + fc1Result.Enabled = true + fc1Result.Whitelist = append(fc1Result.Whitelist, "1", "2") + fc1Result, err = q.UpdateAccountFilterConfig(tt.Ctx, fc1Result) + tt.Assert.Equal(fc1Result.Enabled, true) + tt.Assert.ElementsMatch(fc1Result.Whitelist, []string{"1", "2"}) +} diff --git a/services/horizon/internal/db2/history/main.go b/services/horizon/internal/db2/history/main.go index 0e05b8dc26..81c2148802 100644 --- a/services/horizon/internal/db2/history/main.go +++ b/services/horizon/internal/db2/history/main.go @@ -240,6 +240,7 @@ type AccountEntry struct { type IngestionQ interface { QAccounts + QFilter QAssetStats QClaimableBalances QHistoryClaimableBalances @@ -263,6 +264,7 @@ type IngestionQ interface { CreateAssets(ctx context.Context, assets []xdr.Asset, batchSize int) (map[string]Asset, error) QTransactions QTrustLines + QTxSubmissionResult Begin() error BeginTx(*sql.TxOptions) error diff --git a/services/horizon/internal/db2/history/mock_q_filter.go b/services/horizon/internal/db2/history/mock_q_filter.go new file mode 100644 index 0000000000..281a324ec4 --- /dev/null +++ b/services/horizon/internal/db2/history/mock_q_filter.go @@ -0,0 +1,32 @@ +package history + +import ( + "context" + + "github.com/stretchr/testify/mock" +) + +// MockQAccountFilterWhitelist is a mock implementation of the QAccountFilterWhitelist interface +type MockQFilter struct { + mock.Mock +} + +func (m *MockQFilter) GetAccountFilterConfig(ctx context.Context) (AccountFilterConfig, error) { + a := m.Called(ctx) + return a.Get(0).(AccountFilterConfig), a.Error(1) +} + +func (m *MockQFilter) GetAssetFilterConfig(ctx context.Context) (AssetFilterConfig, error) { + a := m.Called(ctx) + return a.Get(0).(AssetFilterConfig), a.Error(1) +} + +func (m *MockQFilter) UpdateAccountFilterConfig(ctx context.Context, config AccountFilterConfig) (AccountFilterConfig, error) { + a := m.Called(ctx, config) + return a.Get(0).(AccountFilterConfig), a.Error(0) +} + +func (m *MockQFilter) UpdateAssetFilterConfig(ctx context.Context, config AssetFilterConfig) (AssetFilterConfig, error) { + a := m.Called(ctx, config) + return a.Get(0).(AssetFilterConfig), a.Error(0) +} diff --git a/services/horizon/internal/db2/history/mock_q_txsub_result.go b/services/horizon/internal/db2/history/mock_q_txsub_result.go new file mode 100644 index 0000000000..034292cbf9 --- /dev/null +++ b/services/horizon/internal/db2/history/mock_q_txsub_result.go @@ -0,0 +1,39 @@ +package history + +import ( + "context" + "time" + + "github.com/stellar/go/ingest" + "github.com/stretchr/testify/mock" +) + +// MockQTxSubmissionResult is a mock implementation of the QTxSubmissionResult interface +type MockQTxSubmissionResult struct { + mock.Mock +} + +func (m *MockQTxSubmissionResult) GetTxSubmissionResult(ctx context.Context, hash string) (Transaction, error) { + a := m.Called(ctx, hash) + return a.Get(0).(Transaction), a.Error(1) +} + +func (m *MockQTxSubmissionResult) SetTxSubmissionResults(ctx context.Context, transactions []ingest.LedgerTransaction, sequence uint32, ledgerClosetime time.Time) (int64, error) { + a := m.Called(ctx, transactions, sequence) + return a.Get(0).(int64), a.Error(1) +} + +func (m *MockQTxSubmissionResult) InitEmptyTxSubmissionResult(ctx context.Context, hash string, innerHash string) error { + a := m.Called(ctx, hash, innerHash) + return a.Error(0) +} + +func (m *MockQTxSubmissionResult) DeleteTxSubmissionResultsOlderThan(ctx context.Context, howOldInSeconds uint64) (int64, error) { + a := m.Called(ctx, howOldInSeconds) + return a.Get(0).(int64), a.Error(1) +} + +func (m *MockQTxSubmissionResult) GetTxSubmissionResults(ctx context.Context, hashes []string) ([]Transaction, error) { + a := m.Called(ctx, hashes) + return a.Get(0).([]Transaction), a.Error(1) +} diff --git a/services/horizon/internal/db2/history/transaction_batch_insert_builder.go b/services/horizon/internal/db2/history/transaction_batch_insert_builder.go index 1adb2aaa34..5af5476a7e 100644 --- a/services/horizon/internal/db2/history/transaction_batch_insert_builder.go +++ b/services/horizon/internal/db2/history/transaction_batch_insert_builder.go @@ -45,7 +45,7 @@ func (q *Q) NewTransactionBatchInsertBuilder(maxBatchSize int) TransactionBatchI // Add adds a new transaction to the batch func (i *transactionBatchInsertBuilder) Add(ctx context.Context, transaction ingest.LedgerTransaction, sequence uint32) error { - row, err := i.transactionToRow(transaction, sequence) + row, err := transactionToRow(transaction, sequence, i.encodingBuffer) if err != nil { return err } @@ -148,20 +148,20 @@ type TransactionWithoutLedger struct { InnerSignatures pq.StringArray `db:"inner_signatures"` } -func (i *transactionBatchInsertBuilder) transactionToRow(transaction ingest.LedgerTransaction, sequence uint32) (TransactionWithoutLedger, error) { - envelopeBase64, err := i.encodingBuffer.MarshalBase64(transaction.Envelope) +func transactionToRow(transaction ingest.LedgerTransaction, sequence uint32, encodingBuffer *xdr.EncodingBuffer) (TransactionWithoutLedger, error) { + envelopeBase64, err := encodingBuffer.MarshalBase64(transaction.Envelope) if err != nil { return TransactionWithoutLedger{}, err } - resultBase64, err := i.encodingBuffer.MarshalBase64(&transaction.Result.Result) + resultBase64, err := encodingBuffer.MarshalBase64(&transaction.Result.Result) if err != nil { return TransactionWithoutLedger{}, err } - metaBase64, err := i.encodingBuffer.MarshalBase64(transaction.UnsafeMeta) + metaBase64, err := encodingBuffer.MarshalBase64(transaction.UnsafeMeta) if err != nil { return TransactionWithoutLedger{}, err } - feeMetaBase64, err := i.encodingBuffer.MarshalBase64(transaction.FeeChanges) + feeMetaBase64, err := encodingBuffer.MarshalBase64(transaction.FeeChanges) if err != nil { return TransactionWithoutLedger{}, err } diff --git a/services/horizon/internal/db2/history/transaction_batch_insert_builder_test.go b/services/horizon/internal/db2/history/transaction_batch_insert_builder_test.go index a41192720f..c4f83e1062 100644 --- a/services/horizon/internal/db2/history/transaction_batch_insert_builder_test.go +++ b/services/horizon/internal/db2/history/transaction_batch_insert_builder_test.go @@ -91,7 +91,7 @@ func TestTransactionToMap_muxed(t *testing.T) { b := &transactionBatchInsertBuilder{ encodingBuffer: xdr.NewEncodingBuffer(), } - row, err := b.transactionToRow(tx, 20) + row, err := transactionToRow(tx, 20, b.encodingBuffer) assert.NoError(t, err) assert.Equal(t, innerAccountID.Address(), row.Account) @@ -175,7 +175,7 @@ func TestTransactionToMap_SourceMuxedAndFeeSourceUnmuxed(t *testing.T) { b := &transactionBatchInsertBuilder{ encodingBuffer: xdr.NewEncodingBuffer(), } - row, err := b.transactionToRow(tx, 20) + row, err := transactionToRow(tx, 20, b.encodingBuffer) assert.NoError(t, err) assert.Equal(t, innerAccountID.Address(), row.Account) @@ -262,10 +262,7 @@ func TestTransactionToMap_Preconditions(t *testing.T) { }, }, } - b := &transactionBatchInsertBuilder{ - encodingBuffer: xdr.NewEncodingBuffer(), - } - row, err := b.transactionToRow(tx, 20) + row, err := transactionToRow(tx, 20, xdr.NewEncodingBuffer()) assert.NoError(t, err) assert.Equal(t, null.IntFrom(1000), row.TimeBounds.Lower) diff --git a/services/horizon/internal/db2/history/txsub_result.go b/services/horizon/internal/db2/history/txsub_result.go new file mode 100644 index 0000000000..3e55204424 --- /dev/null +++ b/services/horizon/internal/db2/history/txsub_result.go @@ -0,0 +1,163 @@ +package history + +import ( + "context" + "database/sql" + "encoding/json" + "fmt" + "time" + + sq "github.com/Masterminds/squirrel" + "github.com/pkg/errors" + "github.com/stellar/go/ingest" + "github.com/stellar/go/support/db" + "github.com/stellar/go/xdr" +) + +const ( + txSubResultTableName = "txsub_results" + txSubResultHashColumnName = "transaction_hash" + txSubResultInnerHashColumnName = "inner_transaction_hash" + txSubResultColumnName = "tx_result" + txSubResultSubmittedAtColumnName = "submitted_at" +) + +// QTxSubmissionResult defines transaction submission result queries. +type QTxSubmissionResult interface { + GetTxSubmissionResult(ctx context.Context, hash string) (Transaction, error) + GetTxSubmissionResults(ctx context.Context, hashes []string) ([]Transaction, error) + SetTxSubmissionResults(ctx context.Context, transactions []ingest.LedgerTransaction, sequence uint32, ledgerClosetime time.Time) (int64, error) + InitEmptyTxSubmissionResult(ctx context.Context, hash string, innerHash string) error + DeleteTxSubmissionResultsOlderThan(ctx context.Context, howOldInSeconds uint64) (int64, error) +} + +// GetTxSubmissionResult gets the result of a submitted transaction +func (q *Q) GetTxSubmissionResult(ctx context.Context, hash string) (Transaction, error) { + transactions, err := q.GetTxSubmissionResults(ctx, []string{hash}) + if err != nil { + return Transaction{}, err + } + if len(transactions) == 0 { + return Transaction{}, sql.ErrNoRows + } + + return transactions[0], nil +} + +// GetTxSubmissionResults gets the result of multiple submitted transactions +func (q *Q) GetTxSubmissionResults(ctx context.Context, hashes []string) ([]Transaction, error) { + byHash := sq.Select(txSubResultColumnName). + From(txSubResultTableName). + Where(sq.NotEq{txSubResultColumnName: nil}). + Where(map[string]interface{}{ + txSubResultHashColumnName: hashes, + }) + byInnerHash := sq.Select(txSubResultColumnName). + From(txSubResultTableName). + Where(sq.NotEq{txSubResultColumnName: nil}). + Where(map[string]interface{}{ + txSubResultInnerHashColumnName: hashes, + }) + byInnerHashString, args, err := byInnerHash.ToSql() + if err != nil { + return nil, errors.Wrap(err, "could not get string for inner hash sql query") + } + union := byHash.Suffix("UNION ALL "+byInnerHashString, args...) + var result []string + err = q.Select(ctx, &result, union) + if err != nil { + return nil, err + } + + txs := make([]Transaction, len(result)) + for i := 0; i < len(result); i++ { + err = json.Unmarshal([]byte(result[i]), &txs[i]) + if err != nil { + return nil, err + } + } + return txs, err +} + +// SetTxSubmissionResults sets the result of submitted transaction, batching the updates if necessary +func (q *Q) SetTxSubmissionResults(ctx context.Context, transactions []ingest.LedgerTransaction, sequence uint32, ledgerClosetime time.Time) (int64, error) { + // NOTE: it may be worth factoring out this batching into a BatchUpdateBuilder (similar to BatchInsertBuilder) + // when/if we have more update use-cases. + + // Four parameters per transaction, two parameters in each CASE and two in the IN statement + const maxBatchSize = db.PostgresQueryMaxParams/4 + 1 + totalRowsAffected := int64(0) + for len(transactions) > 0 { + batchSize := maxBatchSize + if len(transactions) < maxBatchSize { + batchSize = len(transactions) + } + affected, err := q.setTxSubmissionResults(ctx, transactions[:batchSize], sequence, ledgerClosetime) + if err != nil { + return totalRowsAffected, err + } + totalRowsAffected += affected + transactions = transactions[batchSize:] + } + return totalRowsAffected, nil +} + +// Iterates all the incoming completed transactions, +// updating the submission result in each tx's corresponding row in txsub_result table +// with the tx's serialized JSON blob. +func (q *Q) setTxSubmissionResults(ctx context.Context, transactions []ingest.LedgerTransaction, sequence uint32, ledgerClosetime time.Time) (int64, error) { + caseStmt := sq.Case(txSubResultHashColumnName) + hashes := make([]string, len(transactions)) + encodingBuffer := xdr.NewEncodingBuffer() + for i, transaction := range transactions { + row, err := transactionToRow(transaction, sequence, encodingBuffer) + if err != nil { + return 0, err + } + tx := Transaction{ + LedgerCloseTime: ledgerClosetime, + TransactionWithoutLedger: row, + } + serialized, err := json.Marshal(tx) + if err != nil { + return 0, err + } + caseStmt = caseStmt.When(sq.Expr("?", row.TransactionHash), sq.Expr("?", serialized)) + hashes[i] = row.TransactionHash + } + + sql := sq.Update(txSubResultTableName). + Set(txSubResultColumnName, caseStmt). + Where(sq.Eq{txSubResultHashColumnName: hashes}) + result, err := q.Exec(ctx, sql) + if err != nil { + return 0, err + } + return result.RowsAffected() +} + +// InitEmptyTxSubmissionResult initializes a submitted transaction, idempotent, doesn't matter if row with hash already exists. +func (q *Q) InitEmptyTxSubmissionResult(ctx context.Context, hash string, innerHash string) error { + setMap := map[string]interface{}{ + txSubResultHashColumnName: hash, + } + if innerHash != "" { + setMap[txSubResultInnerHashColumnName] = innerHash + } + sql := sq.Insert(txSubResultTableName). + SetMap(setMap). + Suffix(fmt.Sprintf("ON CONFLICT (%s) DO NOTHING", txSubResultHashColumnName)) + _, err := q.Exec(ctx, sql) + return err +} + +// DeleteTxSubmissionResultsOlderThan deletes entries older than certain duration +func (q *Q) DeleteTxSubmissionResultsOlderThan(ctx context.Context, howOldInSeconds uint64) (int64, error) { + sql := sq.Delete(txSubResultTableName). + Where(sq.Expr("now() >= ("+txSubResultSubmittedAtColumnName+" + interval '1 second' * ?)", howOldInSeconds)) + result, err := q.Exec(ctx, sql) + if err != nil { + return 0, err + } + return result.RowsAffected() +} diff --git a/services/horizon/internal/db2/history/txsub_result_test.go b/services/horizon/internal/db2/history/txsub_result_test.go new file mode 100644 index 0000000000..f137b5dc24 --- /dev/null +++ b/services/horizon/internal/db2/history/txsub_result_test.go @@ -0,0 +1,197 @@ +package history + +import ( + "context" + "database/sql" + "encoding/hex" + "testing" + "time" + + sq "github.com/Masterminds/squirrel" + "github.com/guregu/null" + "github.com/stellar/go/ingest" + "github.com/stellar/go/services/horizon/internal/test" + "github.com/stellar/go/support/db" + "github.com/stellar/go/xdr" +) + +func TestInitIdempotent(t *testing.T) { + tt := test.Start(t) + defer tt.Finish() + test.ResetHorizonDB(t, tt.HorizonDB) + q := &Q{tt.HorizonSession()} + hash := xdr.Hash{0x1, 0x2, 0x3, 0x4} + + // first invocation, creates row + ctx := context.Background() + tt.Assert.NoError(q.InitEmptyTxSubmissionResult(ctx, hash.HexString(), "")) + + // nth invocations on same hash, should be idempotent, if already a row, no-op, no error + tt.Assert.NoError(q.InitEmptyTxSubmissionResult(ctx, hash.HexString(), "")) +} + +func TestInvalidSerializedTX(t *testing.T) { + tt := test.Start(t) + defer tt.Finish() + test.ResetHorizonDB(t, tt.HorizonDB) + q := &Q{tt.HorizonSession()} + hash := xdr.Hash{0x1, 0x2, 0x3, 0x4} + + // first invocation, creates row + ctx := context.Background() + tt.Assert.NoError(q.InitEmptyTxSubmissionResult(ctx, hash.HexString(), "")) + + // put invalid encoded bytes for tx result + sql := sq.Update(txSubResultTableName). + Set(txSubResultColumnName, "garbage"). + Where(sq.Eq{txSubResultHashColumnName: hash.HexString()}) + result, err := q.Exec(ctx, sql) + rows, _ := result.RowsAffected() + tt.Assert.Equal(rows, int64(1)) + tt.Assert.NoError(err) + + // should get err when retrieving due to invalid bytes + _, err = q.GetTxSubmissionResults(ctx, []string{hash.HexString()}) + tt.Assert.Error(err) +} + +func TestTxSubResult(t *testing.T) { + tt := test.Start(t) + defer tt.Finish() + test.ResetHorizonDB(t, tt.HorizonDB) + q := &Q{tt.HorizonSession()} + + sequence := uint32(123) + toInsert := buildLedgerTransaction(tt.T, testTransaction{ + index: 1, + envelopeXDR: "AAAAACiSTRmpH6bHC6Ekna5e82oiGY5vKDEEUgkq9CB//t+rAAAAyAEXUhsAADDRAAAAAAAAAAAAAAABAAAAAAAAAAsBF1IbAABX4QAAAAAAAAAA", + resultXDR: "AAAAAAAAASwAAAAAAAAAAwAAAAAAAAAAAAAAAAAAAAAAAAABAAAAAAAAAAAAAAAFAAAAAAAAAAA=", + feeChangesXDR: "AAAAAA==", + metaXDR: "AAAAAQAAAAAAAAAA", + hash: "19aaa18db88605aedec04659fb45e06f240b022eb2d429e05133e4d53cd945ba", + }) + ledgerCloseTime := time.Now().UTC().Truncate(time.Second) + expected := Transaction{ + LedgerCloseTime: ledgerCloseTime, + TransactionWithoutLedger: TransactionWithoutLedger{ + TotalOrderID: TotalOrderID{528280981504}, + TransactionHash: "19aaa18db88605aedec04659fb45e06f240b022eb2d429e05133e4d53cd945ba", + LedgerSequence: int32(sequence), + ApplicationOrder: 1, + Account: "GAUJETIZVEP2NRYLUESJ3LS66NVCEGMON4UDCBCSBEVPIID773P2W6AY", + AccountSequence: "78621794419880145", + MaxFee: 200, + FeeCharged: 300, + OperationCount: 1, + TxEnvelope: "AAAAACiSTRmpH6bHC6Ekna5e82oiGY5vKDEEUgkq9CB//t+rAAAAyAEXUhsAADDRAAAAAAAAAAAAAAABAAAAAAAAAAsBF1IbAABX4QAAAAAAAAAA", + TxResult: "AAAAAAAAASwAAAAAAAAAAwAAAAAAAAAAAAAAAAAAAAAAAAABAAAAAAAAAAAAAAAFAAAAAAAAAAA=", + TxFeeMeta: "AAAAAA==", + TxMeta: "AAAAAQAAAAAAAAAA", + Signatures: []string{}, + ExtraSigners: nil, + InnerSignatures: nil, + MemoType: "none", + Memo: null.NewString("", false), + Successful: true, + TimeBounds: TimeBounds{Null: true}, + LedgerBounds: LedgerBounds{Null: true}, + }, + } + + hash := hex.EncodeToString(toInsert.Result.TransactionHash[:]) + ctx := context.Background() + + _, err := q.GetTxSubmissionResult(ctx, hash) + tt.Assert.Error(err) + tt.Assert.Equal(err, sql.ErrNoRows) + transactions, err := q.GetTxSubmissionResults(ctx, []string{hash}) + tt.Assert.NoError(err) + tt.Assert.Len(transactions, 0) + + tt.Assert.NoError(q.InitEmptyTxSubmissionResult(ctx, hash, "")) + + _, err = q.GetTxSubmissionResult(ctx, hash) + tt.Assert.Error(err) + tt.Assert.Equal(err, sql.ErrNoRows) + + transactions, err = q.GetTxSubmissionResults(ctx, []string{hash}) + tt.Assert.NoError(err) + tt.Assert.Len(transactions, 0) + + // Trying to set the result of a transaction which wasn't initialized + // doesn't fail + toInsertFail := toInsert + toInsertFail.Result.TransactionHash = xdr.Hash{0x1, 0x2, 0x3, 0x4} + affectedRows, err := q.SetTxSubmissionResults(ctx, []ingest.LedgerTransaction{toInsertFail}, sequence, ledgerCloseTime) + tt.Assert.NoError(err) + tt.Assert.Equal(int64(0), affectedRows) + + // Now insert the valid transaction + affectedRows, err = q.SetTxSubmissionResults(ctx, []ingest.LedgerTransaction{toInsert}, sequence, ledgerCloseTime) + tt.Assert.NoError(err) + tt.Assert.Equal(int64(1), affectedRows) + transaction, err := q.GetTxSubmissionResult(ctx, hash) + tt.Assert.NoError(err) + + // ignore created time and updated time + transaction.CreatedAt = expected.CreatedAt + transaction.UpdatedAt = expected.UpdatedAt + + // compare ClosedAt separately because reflect.DeepEqual does not handle time.Time + closedAt := transaction.LedgerCloseTime + transaction.LedgerCloseTime = expected.LedgerCloseTime + + tt.Assert.True(closedAt.Equal(expected.LedgerCloseTime)) + tt.Assert.Equal(transaction, expected) + + transactions, err = q.GetTxSubmissionResults(ctx, []string{hash}) + tt.Assert.NoError(err) + tt.Assert.Len(transactions, 1) + + time.Sleep(2 * time.Second) + affectedRows, err = q.DeleteTxSubmissionResultsOlderThan(ctx, 1) + tt.Assert.NoError(err) + tt.Assert.Equal(int64(1), affectedRows) + + _, err = q.GetTxSubmissionResult(ctx, hash) + tt.Assert.Error(err) + tt.Assert.Equal(err, sql.ErrNoRows) + + transactions, err = q.GetTxSubmissionResults(ctx, []string{hash}) + tt.Assert.NoError(err) + tt.Assert.Len(transactions, 0) + + // test querying by inner hash + innerHash := "lambada" + tt.Assert.NoError(q.InitEmptyTxSubmissionResult(ctx, hash, innerHash)) + _, err = q.SetTxSubmissionResults(ctx, []ingest.LedgerTransaction{toInsert}, sequence, ledgerCloseTime) + tt.Assert.NoError(err) + _, err = q.GetTxSubmissionResult(ctx, innerHash) + tt.Assert.NoError(err) + +} + +func TestSetTxSubResultBatching(t *testing.T) { + tt := test.Start(t) + defer tt.Finish() + test.ResetHorizonDB(t, tt.HorizonDB) + q := &Q{tt.HorizonSession()} + + transactionLen := db.PostgresQueryMaxParams + 3 + transactions := make([]ingest.LedgerTransaction, transactionLen, transactionLen) + for i := range transactions { + transactions[i] = buildLedgerTransaction(tt.T, testTransaction{ + index: 1, + envelopeXDR: "AAAAACiSTRmpH6bHC6Ekna5e82oiGY5vKDEEUgkq9CB//t+rAAAAyAEXUhsAADDRAAAAAAAAAAAAAAABAAAAAAAAAAsBF1IbAABX4QAAAAAAAAAA", + resultXDR: "AAAAAAAAASwAAAAAAAAAAwAAAAAAAAAAAAAAAAAAAAAAAAABAAAAAAAAAAAAAAAFAAAAAAAAAAA=", + feeChangesXDR: "AAAAAA==", + metaXDR: "AAAAAQAAAAAAAAAA", + hash: "19aaa18db88605aedec04659fb45e06f240b022eb2d429e05133e4d53cd945ba", + }) + } + + ctx := context.Background() + updatedRows, err := q.SetTxSubmissionResults(ctx, transactions, 0, time.Now()) + tt.Assert.NoError(err) + tt.Assert.Equal(int64(0), updatedRows) +} diff --git a/services/horizon/internal/db2/schema/bindata.go b/services/horizon/internal/db2/schema/bindata.go index 6e3e6bbd20..8b898e66ce 100644 --- a/services/horizon/internal/db2/schema/bindata.go +++ b/services/horizon/internal/db2/schema/bindata.go @@ -50,6 +50,7 @@ // migrations/52_add_trade_type_index.sql (424B) // migrations/53_add_trades_rounding_slippage.sql (274B) // migrations/54_tx_preconditions_and_account_fields.sql (1.355kB) +// migrations/55_filter_rules.sql (893B) // migrations/5_create_trades_table.sql (1.1kB) // migrations/6_create_assets_table.sql (366B) // migrations/7_modify_trades_table.sql (2.303kB) @@ -1124,6 +1125,26 @@ func migrations54_tx_preconditions_and_account_fieldsSql() (*asset, error) { return a, nil } +var _migrations55_filter_rulesSql = []byte("\x1f\x8b\x08\x00\x00\x00\x00\x00\x00\xff\xc4\x92\x31\x8f\xd3\x40\x10\x85\x7b\xff\x8a\xe9\x2e\x11\x31\xa2\x40\x34\xa9\x02\x31\x52\x24\xcb\x81\x9c\x0d\x05\x42\xd6\xd8\x3b\x3e\x8f\xb4\xde\xb5\x76\xc6\x5c\x00\xf1\xdf\x51\xce\x77\xce\x99\x04\x5a\xb6\xfe\xde\xdb\xe7\xcf\x1b\xc7\xf0\xa2\xe3\xbb\x80\x4a\x50\xf4\x51\xf4\xee\x90\x6c\xf2\x04\xf2\xcd\xdb\x34\x01\xac\x6b\x3f\x38\x2d\x1b\xb6\x4a\xa1\x0c\x83\x25\x81\x45\x04\x00\x40\x0e\x2b\x4b\x06\x2a\xef\x2d\x64\xfb\x1c\xb2\x22\x4d\xc1\x50\x83\x83\x55\x68\xd0\x0a\xad\x1e\xc0\xfb\x96\x95\x2c\x8b\xc2\x37\x0c\x75\x8b\xe1\xcb\xd7\x89\x1f\x09\x8b\xa2\x65\xe7\x0d\x37\x7c\x2a\xe4\x3b\x76\x3a\x21\xd1\x72\xfd\xe7\x28\x11\xfa\xff\x93\xe2\x18\xd8\x09\x05\x05\x6d\x69\xba\xc4\xb0\x8c\x1b\x44\x4f\x42\x1b\x1f\x80\xb0\x6e\x41\x86\xbe\xf7\x41\xc9\xc0\xb8\x1b\xb8\xeb\x2d\x75\xe4\x14\x95\xbd\x8b\x76\xd9\x6d\x72\xc8\x61\x97\xe5\xfb\xeb\xd2\x3f\x6d\xd2\x22\xb9\x85\xc5\xf8\x15\x70\xf3\xf3\xd7\xcd\x0a\x5e\x2d\xd7\xf3\xe4\xa5\x99\xbf\xe6\xe6\x4e\xf5\x28\x43\x55\x06\x92\xc1\xea\x93\x4e\x0d\xe8\x04\xeb\xd3\xbe\xb2\x45\x69\x61\x3c\x8f\xca\x16\x6f\x5e\x2f\xcf\x92\x8b\x6c\xf7\xb1\x48\x46\x77\xec\x1c\x85\xf2\x22\xfd\x2c\x37\x72\x7a\x7c\xbc\x10\x66\x47\xe9\xa8\x2b\x88\x63\x10\x0a\x8c\x96\x7f\x90\x81\x96\x45\x7d\xf8\xfe\x32\x3f\x97\x3e\x54\xc8\x50\x75\xac\x4a\xa6\xc4\xe7\x2d\xca\x1d\x89\x62\xd7\x9f\x07\x6e\x93\xf7\x9b\x22\xcd\x21\xdb\x7f\x5e\x2c\x9f\x7e\xe0\xf4\xf0\xb7\xfe\xde\x45\xd1\xf6\xb0\xff\xf0\xaf\x87\x5f\xa3\xd4\x68\x68\x3d\x03\x2f\x95\x5f\xc3\xe6\x7e\x27\xe2\x77\x00\x00\x00\xff\xff\xa6\x50\xb1\x3f\x7d\x03\x00\x00") + +func migrations55_filter_rulesSqlBytes() ([]byte, error) { + return bindataRead( + _migrations55_filter_rulesSql, + "migrations/55_filter_rules.sql", + ) +} + +func migrations55_filter_rulesSql() (*asset, error) { + bytes, err := migrations55_filter_rulesSqlBytes() + if err != nil { + return nil, err + } + + info := bindataFileInfo{name: "migrations/55_filter_rules.sql", size: 0, mode: os.FileMode(0), modTime: time.Unix(0, 0)} + a := &asset{bytes: bytes, info: info, digest: [32]uint8{0x38, 0x43, 0xd4, 0x1, 0x66, 0xe5, 0xf6, 0x21, 0x51, 0xd1, 0xd1, 0x96, 0x82, 0x36, 0xf5, 0xe7, 0x48, 0x82, 0x12, 0xcb, 0x5c, 0x2, 0x11, 0xc1, 0xb, 0x1f, 0xa4, 0x83, 0x1e, 0x57, 0xd7, 0xdd}} + return a, nil +} + var _migrations5_create_trades_tableSql = []byte("\x1f\x8b\x08\x00\x00\x00\x00\x00\x00\xff\x94\x94\x51\x6f\xaa\x40\x10\x85\xdf\xf9\x15\x13\x9f\x30\x17\x93\x7b\x6f\x5a\x5f\x4c\x9a\x58\x25\xad\xa9\xc1\xd6\x4a\xd2\x37\xb2\xb0\x23\x6c\xa2\x2c\x99\x1d\xda\xf0\xef\x1b\x68\x69\x10\x57\xad\xaf\x9c\x39\x67\x38\xbb\x5f\x76\x34\x82\x3f\x7b\x95\x92\x60\x84\xb0\x70\x66\x6b\x7f\xba\xf1\x61\x33\xbd\x5f\xfa\x90\x29\xc3\x9a\xaa\x88\x49\x48\x34\xe0\x3a\x00\xf0\xf3\x51\x17\x48\x82\x95\xce\x23\x25\x21\x56\xa9\xca\x19\x82\xd5\x06\x82\x70\xb9\xf4\x9a\xc9\x81\x26\x89\x34\x00\x95\x33\xa6\x48\x1d\xb5\x91\xf5\x76\x8b\x64\x35\x37\xb2\xc1\xdd\xee\x84\x5e\xcb\x71\x59\x9d\x75\xeb\x9d\x8c\x84\x31\xc8\x11\x57\x05\x42\x92\x09\x12\x09\x23\xc1\xbb\xa0\x4a\xe5\xa9\x3b\xbe\x19\xf6\x22\x3b\x1e\x65\x4c\x89\x64\x71\xdd\x8e\xcf\xb8\x12\x2d\x6d\x9b\xfe\xfd\xb7\x7b\xf6\xba\xcc\xb9\xff\xff\x30\x7b\xf4\x67\x4f\xe0\x76\x47\xee\xe0\xef\xf0\xbb\x57\xac\xcb\x34\xe3\x6b\x9b\x1d\xb8\xae\xe8\x76\xe0\xfb\x75\xbb\xd6\x75\xb6\xdf\xe1\x50\xdd\xd0\x19\x4e\x9c\x96\xbf\x30\x58\xbc\x84\x3e\x2c\x82\xb9\xff\x06\x19\x93\x8c\x0a\x25\x61\x15\xf4\x91\x0c\x5f\x17\xc1\x03\xc4\x4c\x88\xe0\xda\xc8\xf4\x5a\x0a\x3b\xe1\x9d\xd4\xb8\x8a\x1a\x0c\x2f\x45\xb7\xac\xda\x52\xea\x90\xfa\xb6\x2e\x65\xf4\x90\xf4\xfa\xe4\x78\xc7\x00\x9e\x5a\xf7\x75\x78\x97\x16\x1e\xb1\xe2\x1d\x5f\xa8\x67\x63\xa3\x5e\xdb\x7d\x17\xe6\xfa\x23\x77\xe6\xeb\xd5\xb3\xfd\x5d\x48\x84\x49\x84\xc4\x89\xf3\x19\x00\x00\xff\xff\x79\x87\x24\x6b\x4c\x04\x00\x00") func migrations5_create_trades_tableSqlBytes() ([]byte, error) { @@ -1385,6 +1406,7 @@ var _bindata = map[string]func() (*asset, error){ "migrations/52_add_trade_type_index.sql": migrations52_add_trade_type_indexSql, "migrations/53_add_trades_rounding_slippage.sql": migrations53_add_trades_rounding_slippageSql, "migrations/54_tx_preconditions_and_account_fields.sql": migrations54_tx_preconditions_and_account_fieldsSql, + "migrations/55_filter_rules.sql": migrations55_filter_rulesSql, "migrations/5_create_trades_table.sql": migrations5_create_trades_tableSql, "migrations/6_create_assets_table.sql": migrations6_create_assets_tableSql, "migrations/7_modify_trades_table.sql": migrations7_modify_trades_tableSql, @@ -1485,6 +1507,7 @@ var _bintree = &bintree{nil, map[string]*bintree{ "52_add_trade_type_index.sql": &bintree{migrations52_add_trade_type_indexSql, map[string]*bintree{}}, "53_add_trades_rounding_slippage.sql": &bintree{migrations53_add_trades_rounding_slippageSql, map[string]*bintree{}}, "54_tx_preconditions_and_account_fields.sql": &bintree{migrations54_tx_preconditions_and_account_fieldsSql, map[string]*bintree{}}, + "55_filter_rules.sql": &bintree{migrations55_filter_rulesSql, map[string]*bintree{}}, "5_create_trades_table.sql": &bintree{migrations5_create_trades_tableSql, map[string]*bintree{}}, "6_create_assets_table.sql": &bintree{migrations6_create_assets_tableSql, map[string]*bintree{}}, "7_modify_trades_table.sql": &bintree{migrations7_modify_trades_tableSql, map[string]*bintree{}}, diff --git a/services/horizon/internal/db2/schema/migrations/55_filter_rules.sql b/services/horizon/internal/db2/schema/migrations/55_filter_rules.sql new file mode 100644 index 0000000000..6c0ba2e7ba --- /dev/null +++ b/services/horizon/internal/db2/schema/migrations/55_filter_rules.sql @@ -0,0 +1,30 @@ +-- +migrate Up + +CREATE TABLE account_filter_rules ( + enabled bool NOT NULL default false, + whitelist varchar[] NOT NULL, + last_modified bigint NOT NULL +); + +CREATE TABLE asset_filter_rules ( + enabled bool NOT NULL default false, + whitelist varchar[] NOT NULL, + last_modified bigint NOT NULL +); + +-- insert the default disabled state for each supported filter implementation +INSERT INTO account_filter_rules VALUES (false, '{}', 0); +INSERT INTO asset_filter_rules VALUES (false, '{}', 0); + +CREATE TABLE txsub_results ( + transaction_hash varchar(64) NOT NULL UNIQUE, + inner_transaction_hash varchar(64), + tx_result text, -- serialized history.Transaction + submitted_at timestamp NOT NULL DEFAULT NOW() +); + +-- +migrate Down + +DROP TABLE account_filter_rules cascade; +DROP TABLE asset_filter_rules cascade; +DROP TABLE txsub_results cascade; diff --git a/services/horizon/internal/flags.go b/services/horizon/internal/flags.go index d4651e2ef1..50a9e51588 100644 --- a/services/horizon/internal/flags.go +++ b/services/horizon/internal/flags.go @@ -199,6 +199,14 @@ func Flags() (*Config, support.ConfigOptions) { Usage: "causes Horizon to ingest from a Captive Stellar Core process instead of a persistent Stellar Core database", ConfigKey: &config.EnableCaptiveCoreIngestion, }, + &support.ConfigOption{ + Name: "enable-ingestion-filtering", + OptType: types.Bool, + FlagDefault: false, + Required: false, + Usage: "causes Horizon to enable Ingestion filtering and the ingestion admin HTTP endpoint at /ingestion/filter", + ConfigKey: &config.EnableIngestionFiltering, + }, &support.ConfigOption{ Name: "captive-core-http-port", OptType: types.Uint, diff --git a/services/horizon/internal/httpx/main.go b/services/horizon/internal/httpx/main.go new file mode 100644 index 0000000000..a73c8e9b38 --- /dev/null +++ b/services/horizon/internal/httpx/main.go @@ -0,0 +1,8 @@ +package httpx + +import "embed" + +var ( + //go:embed static + staticFiles embed.FS +) diff --git a/services/horizon/internal/httpx/router.go b/services/horizon/internal/httpx/router.go index d78042a7cc..6d6757d402 100644 --- a/services/horizon/internal/httpx/router.go +++ b/services/horizon/internal/httpx/router.go @@ -33,20 +33,21 @@ type RouterConfig struct { TxSubmitter *txsub.System RateQuota *throttled.RateQuota - BehindCloudflare bool - BehindAWSLoadBalancer bool - SSEUpdateFrequency time.Duration - StaleThreshold uint - ConnectionTimeout time.Duration - NetworkPassphrase string - MaxPathLength uint - MaxAssetsPerPathRequest int - PathFinder paths.Finder - PrometheusRegistry *prometheus.Registry - CoreGetter actions.CoreStateGetter - HorizonVersion string - FriendbotURL *url.URL - HealthCheck http.Handler + BehindCloudflare bool + BehindAWSLoadBalancer bool + SSEUpdateFrequency time.Duration + StaleThreshold uint + ConnectionTimeout time.Duration + NetworkPassphrase string + MaxPathLength uint + MaxAssetsPerPathRequest int + PathFinder paths.Finder + PrometheusRegistry *prometheus.Registry + CoreGetter actions.CoreStateGetter + HorizonVersion string + FriendbotURL *url.URL + HealthCheck http.Handler + EnableIngestionFiltering bool } type Router struct { @@ -337,7 +338,25 @@ func (r *Router) addRoutes(config *RouterConfig, rateLimiter *throttled.HTTPRate }) // internal + r.Internal.Get("/", func(w http.ResponseWriter, r *http.Request) { + p, err := staticFiles.ReadFile("static/admin_oapi.yml") + if err != nil { + w.WriteHeader(http.StatusNotFound) + return + } + w.Header().Set("Content-Type", "application/openapi+yaml") + w.Write(p) + }) r.Internal.Get("/metrics", promhttp.HandlerFor(config.PrometheusRegistry, promhttp.HandlerOpts{}).ServeHTTP) r.Internal.Get("/debug/pprof/heap", pprof.Index) r.Internal.Get("/debug/pprof/profile", pprof.Profile) + if config.EnableIngestionFiltering { + r.Internal.Route("/ingestion/filters", func(r chi.Router) { + handler := actions.FilterConfigHandler{} + r.With(historyMiddleware).Put("/asset", handler.UpdateAssetConfig) + r.With(historyMiddleware).Put("/account", handler.UpdateAccountConfig) + r.With(historyMiddleware).Get("/asset", handler.GetAssetConfig) + r.With(historyMiddleware).Get("/account", handler.GetAccountConfig) + }) + } } diff --git a/services/horizon/internal/httpx/static/admin_oapi.yml b/services/horizon/internal/httpx/static/admin_oapi.yml new file mode 100644 index 0000000000..2919af59e7 --- /dev/null +++ b/services/horizon/internal/httpx/static/admin_oapi.yml @@ -0,0 +1,203 @@ +openapi: 3.0.3 +info: + title: Horizon Admin API + version: 1.0.0 + description: |- + The Admin API is optionally published on separate local port and provides access to + some aspects of server config and settings. It is only enabled if runtime parameter `--admin-port=` is specified. +servers: + - url: http://localhost:4200/ +paths: + /metrics: + get: + responses: + '200': + description: OK + headers: {} + content: + text/plain: + example: | + # HELP go_gc_duration_seconds A summary of the GC invocation durations. + # TYPE go_gc_duration_seconds summary + go_gc_duration_seconds{quantile="0"} 2.7834e-05 + go_gc_duration_seconds{quantile="0.25"} 0.000158374 + go_gc_duration_seconds{quantile="0.5"} 0.000334749 + go_gc_duration_seconds{quantile="0.75"} 0.000922251 + go_gc_duration_seconds{quantile="1"} 0.02497575 + go_gc_duration_seconds_sum 2.140231182 + go_gc_duration_seconds_count 7466 + ... many, many more + summary: Get latest metrics on server runtime + operationId: Get latest metrics on server runtime + description: '' + tags: [] + parameters: [] + /pprof/heap: + get: + responses: + '200': + description: OK + headers: {} + content: + application/octet-stream: + example: | + ... binary + summary: Get golang performance heap dump + operationId: Get golang performance heap dump + description: '' + tags: [] + parameters: [] + /pprof/profile: + get: + responses: + '200': + description: OK + headers: {} + content: + application/octet-stream: + example: | + ... binary + summary: Get golang performance profile dump + operationId: Get golang performance profile dump + description: '' + tags: [] + parameters: [] + /ingestion/filters/asset: + get: + responses: + '200': + description: OK + headers: {} + content: + application/json: + schema: + $ref: '#/components/schemas/AssetConfigExisting' + summary: Get Asset Filter Config + operationId: Get Asset Filter Config + description: Retrieve the configuration for the Asset Filter. + tags: [] + parameters: [] + put: + responses: + '200': + description: OK + headers: {} + content: + application/json: + schema: + $ref: '#/components/schemas/AssetConfigExisting' + summary: Update the Asset Filter Config + operationId: Update the Asset Filter Config + description: Send the new configuration model which will replace current for Asset Filter. + tags: [] + parameters: [] + requestBody: + required: true + content: + application/json: + schema: + $ref: '#/components/schemas/AssetConfigNew' + /ingestion/filters/account: + get: + responses: + '200': + description: OK + headers: {} + content: + application/json: + schema: + $ref: '#/components/schemas/AccountConfigExisting' + summary: Get Account Filter Config + operationId: Get Account Filter Config + description: Retrieve the configuration for the Account Filter. + tags: [] + parameters: [] + put: + responses: + '200': + description: OK + headers: {} + content: + application/json: + schema: + $ref: '#/components/schemas/AccountConfigExisting' + summary: Update the Account Filter Config + operationId: Update the Account Filter Config + description: Send the new configuration model which will replace current for Account Filter. + tags: [] + parameters: [] + requestBody: + required: true + content: + application/json: + schema: + $ref: '#/components/schemas/AccountConfigNew' +components: + schemas: + AssetConfigNew: + title: New Asset Config Model + type: object + properties: + whitelist: + type: array + items: + type: string + description: |- + a list of canonical asset ids which the asset filter will inspect ledger transactions, if any transaction operations reference the asset id, then the transaction is ingested to local horizon history database, otherwise it will be skipped. + example: + - 'usdc:1234' + - 'dotx:1234' + - 'abdc:1234' + enabled: + type: boolean + description: |- + if disabled, the asset filter will not be executed during ingeestion. + example: true + required: + - whitelist + - enabled + AccountConfigNew: + title: New Account Config Model + type: object + properties: + whitelist: + type: array + items: + type: string + description: |- + a list of account ids which account filter will inspect ledger transactions, if any transaction operations reference the account, then the transaction is ingested to local horizon history database, otherwise it will be skipped. + example: + - 'accountid1' + - 'accountid2' + - 'accountid3' + enabled: + type: boolean + description: |- + if disabled, the account filter will not be executed during ingeestion. + example: true + required: + - whitelist + - enabled + AccountConfigExisting: + title: Existing Account Config Model + type: object + allOf: + - $ref: '#/components/schemas/AccountConfigNew' + - properties: + last_modified: + type: integer + description: |- + unix epoch timestamp in seconds. + example: 1647121423 + AssetConfigExisting: + title: Existing Asset Config Model + type: object + allOf: + - $ref: '#/components/schemas/AssetConfigNew' + - properties: + last_modified: + type: integer + description: |- + unix epoch timestamp in seconds. + example: 1647121423 +tags: [] diff --git a/services/horizon/internal/ingest/filters/account.go b/services/horizon/internal/ingest/filters/account.go new file mode 100644 index 0000000000..601f67c8ee --- /dev/null +++ b/services/horizon/internal/ingest/filters/account.go @@ -0,0 +1,61 @@ +package filters + +import ( + "context" + + "github.com/stellar/go/ingest" + "github.com/stellar/go/services/horizon/internal/db2/history" + "github.com/stellar/go/services/horizon/internal/ingest/processors" +) + +type accountFilter struct { + whitelistedAccountsSet map[string]struct{} + lastModified int64 + enabled bool +} + +type AccountFilter interface { + processors.LedgerTransactionFilterer + RefreshAccountFilter(filterConfig *history.AccountFilterConfig) error +} + +func NewAccountFilter() AccountFilter { + return &accountFilter{ + whitelistedAccountsSet: map[string]struct{}{}, + } +} + +func (filter *accountFilter) RefreshAccountFilter(filterConfig *history.AccountFilterConfig) error { + // only need to re-initialize the filter config state(rules) if its cached version(in memory) + // is older than the incoming config version based on lastModified epoch timestamp + if filterConfig.LastModified > filter.lastModified { + logger.Infof("New Account Filter config detected, reloading new config %v ", *filterConfig) + + filter.enabled = filterConfig.Enabled + filter.whitelistedAccountsSet = listToMap(filterConfig.Whitelist) + filter.lastModified = filterConfig.LastModified + } + + return nil +} + +func (f *accountFilter) FilterTransaction(ctx context.Context, transaction ingest.LedgerTransaction) (bool, error) { + // filtering is disabled if the whitelist is empty for now, as that is the only filter rule + if len(f.whitelistedAccountsSet) == 0 || !f.enabled { + return true, nil + } + + participants, err := processors.ParticipantsForTransaction(0, transaction) + if err != nil { + return false, err + } + + // NOTE: this assumes that the participant list has a small memory footprint + // otherwise, we should be doing the filtering on the DB side + for _, p := range participants { + if _, ok := f.whitelistedAccountsSet[p.Address()]; ok { + return true, nil + } + } + return false, nil +} diff --git a/services/horizon/internal/ingest/filters/account_test.go b/services/horizon/internal/ingest/filters/account_test.go new file mode 100644 index 0000000000..1831a6a6e5 --- /dev/null +++ b/services/horizon/internal/ingest/filters/account_test.go @@ -0,0 +1,149 @@ +package filters + +import ( + "context" + "testing" + + "github.com/stretchr/testify/assert" + "github.com/stretchr/testify/require" + + "github.com/stellar/go/ingest" + "github.com/stellar/go/services/horizon/internal/db2/history" + "github.com/stellar/go/xdr" +) + +func TestAccountFilterAllowsWhenMatch(t *testing.T) { + tt := assert.New(t) + ctx := context.Background() + + filterConfig := &history.AccountFilterConfig{ + Whitelist: []string{"GD6WNNTW664WH7FXC5RUMUTF7P5QSURC2IT36VOQEEGFZ4UWUEQGECAL"}, + Enabled: true, + LastModified: 1, + } + + filter := NewAccountFilter() + err := filter.RefreshAccountFilter(filterConfig) + tt.NoError(err) + + result, err := filter.FilterTransaction(ctx, getAccountTestTx(t, + "GD6WNNTW664WH7FXC5RUMUTF7P5QSURC2IT36VOQEEGFZ4UWUEQGECAL", + "GBRPYHIL2CI3FNQ4BXLFMNDLFJUNPU2HY3ZMFSHONUCEOASW7QC7OX2H")) + + tt.NoError(err) + tt.Equal(result, true) +} + +func TestAccountFilterAllowsWhenDisabled(t *testing.T) { + tt := assert.New(t) + ctx := context.Background() + + filterConfig := &history.AccountFilterConfig{ + Whitelist: []string{"GD6WNNTW664WH7FXC5RUMUTF7P5QSURC2IT36VOQEEGFZ4UWUEQGECAL"}, + Enabled: false, + LastModified: 1, + } + filter := NewAccountFilter() + err := filter.RefreshAccountFilter(filterConfig) + tt.NoError(err) + + result, err := filter.FilterTransaction(ctx, getAccountTestTx(t, + "GBRPYHIL2CI3FNQ4BXLFMNDLFJUNPU2HY3ZMFSHONUCEOASW7QC7OX2H", + "GBRPYHIL2CI3FNQ4BXLFMNDLFJUNPU2HY3ZMFSHONUCEOASW7QC7OX2H")) + + tt.NoError(err) + + // there is no match on filter rule, but since filter is disabled, it should allow all + tt.Equal(result, true) +} + +func TestAccountFilterAllowsWhenEmptyWhitelist(t *testing.T) { + tt := assert.New(t) + ctx := context.Background() + + filterConfig := &history.AccountFilterConfig{ + Whitelist: []string{}, + Enabled: true, + LastModified: 1, + } + filter := NewAccountFilter() + err := filter.RefreshAccountFilter(filterConfig) + tt.NoError(err) + + result, err := filter.FilterTransaction(ctx, getAccountTestTx(t, + "GD6WNNTW664WH7FXC5RUMUTF7P5QSURC2IT36VOQEEGFZ4UWUEQGECAL", + "GBRPYHIL2CI3FNQ4BXLFMNDLFJUNPU2HY3ZMFSHONUCEOASW7QC7OX2H")) + + tt.NoError(err) + tt.Equal(result, true) +} + +func TestAccountFilterDoesNotAllowWhenNoMatch(t *testing.T) { + tt := assert.New(t) + ctx := context.Background() + + filterConfig := &history.AccountFilterConfig{ + Whitelist: []string{"GD6WNNTW664WH7FXC5RUMUTF7P5QSURC2IT36VOQEEGFZ4UWUEQGECAL"}, + Enabled: true, + LastModified: 1, + } + + filter := NewAccountFilter() + err := filter.RefreshAccountFilter(filterConfig) + tt.NoError(err) + + result, err := filter.FilterTransaction(ctx, getAccountTestTx(t, + "GBRPYHIL2CI3FNQ4BXLFMNDLFJUNPU2HY3ZMFSHONUCEOASW7QC7OX2H", + "GBRPYHIL2CI3FNQ4BXLFMNDLFJUNPU2HY3ZMFSHONUCEOASW7QC7OX2H")) + + tt.NoError(err) + tt.Equal(result, false) +} + +func getAccountTestTx(t *testing.T, accountId string, issuer string) ingest.LedgerTransaction { + + var xdrAssetCode [12]byte + var xdrIssuer xdr.AccountId + copy(xdrAssetCode[:], "USDC") + require.NoError(t, xdrIssuer.SetAddress(issuer)) + + return ingest.LedgerTransaction{ + UnsafeMeta: xdr.TransactionMeta{ + V: 1, + V1: &xdr.TransactionMetaV1{ + Operations: []xdr.OperationMeta{}, + }, + }, + Result: xdr.TransactionResultPair{ + Result: xdr.TransactionResult{ + Result: xdr.TransactionResultResult{ + Code: xdr.TransactionResultCodeTxSuccess, + }, + }, + }, + Envelope: xdr.TransactionEnvelope{ + Type: xdr.EnvelopeTypeEnvelopeTypeTx, + V1: &xdr.TransactionV1Envelope{ + Tx: xdr.Transaction{ + SourceAccount: xdr.MustMuxedAddress(accountId), + Operations: []xdr.Operation{ + {Body: xdr.OperationBody{ + Type: xdr.OperationTypePayment, + PaymentOp: &xdr.PaymentOp{ + Destination: xdr.MustMuxedAddress(accountId), + Asset: xdr.Asset{ + Type: xdr.AssetTypeAssetTypeCreditAlphanum12, + AlphaNum12: &xdr.AlphaNum12{ + AssetCode: xdrAssetCode, + Issuer: xdrIssuer, + }, + }, + Amount: 100, + }, + }}, + }, + }, + }, + }, + } +} diff --git a/services/horizon/internal/ingest/filters/asset.go b/services/horizon/internal/ingest/filters/asset.go new file mode 100644 index 0000000000..f116eacb68 --- /dev/null +++ b/services/horizon/internal/ingest/filters/asset.go @@ -0,0 +1,143 @@ +package filters + +import ( + "context" + + "github.com/stellar/go/services/horizon/internal/db2/history" + "github.com/stellar/go/services/horizon/internal/ingest/processors" + "github.com/stellar/go/support/log" + "github.com/stellar/go/xdr" + + "github.com/stellar/go/ingest" +) + +var ( + logger = log.WithFields(log.F{ + "ingest filter": "asset", + }) +) + +type assetFilter struct { + canonicalAssetsLookup map[string]struct{} + lastModified int64 + enabled bool +} + +type AssetFilter interface { + processors.LedgerTransactionFilterer + RefreshAssetFilter(filterConfig *history.AssetFilterConfig) error +} + +func NewAssetFilter() AssetFilter { + return &assetFilter{ + canonicalAssetsLookup: map[string]struct{}{}, + } +} + +func (filter *assetFilter) RefreshAssetFilter(filterConfig *history.AssetFilterConfig) error { + // only need to re-initialize the filter config state(rules) if it's cached version(in memory) + // is older than the incoming config version based on lastModified epoch timestamp + if filterConfig.LastModified > filter.lastModified { + logger.Infof("New Asset Filter config detected, reloading new config %v ", *filterConfig) + filter.enabled = filterConfig.Enabled + filter.canonicalAssetsLookup = listToMap(filterConfig.Whitelist) + filter.lastModified = filterConfig.LastModified + } + + return nil +} + +func (f *assetFilter) FilterTransaction(ctx context.Context, transaction ingest.LedgerTransaction) (bool, error) { + // filtering is disabled if the whitelist is empty for now as that is the only filter rule + if len(f.canonicalAssetsLookup) < 1 || !f.enabled { + return true, nil + } + + var operations []xdr.Operation + + if txv1, v1Exists := transaction.Envelope.GetV1(); v1Exists { + operations = txv1.Tx.Operations + } + + if txv0, v0Exists := transaction.Envelope.GetV0(); v0Exists { + operations = txv0.Tx.Operations + } + + if f.filterOperationsMatchedOnRules(operations) { + return true, nil + } + + logger.Debugf("No match, dropped tx with seq %v ", transaction.Envelope.SeqNum()) + return false, nil +} + +func (f assetFilter) filterOperationsMatchedOnRules(operations []xdr.Operation) bool { + for _, operation := range operations { + switch operation.Body.Type { + case xdr.OperationTypeChangeTrust: + if f.filterChangeTrustMatched(operation) { + return true + } + case xdr.OperationTypeManageSellOffer: + if f.assetMatchedFilter(&operation.Body.ManageSellOfferOp.Buying) || f.assetMatchedFilter(&operation.Body.ManageSellOfferOp.Selling) { + return true + } + case xdr.OperationTypeManageBuyOffer: + if f.assetMatchedFilter(&operation.Body.ManageBuyOfferOp.Buying) || f.assetMatchedFilter(&operation.Body.ManageBuyOfferOp.Selling) { + return true + } + case xdr.OperationTypeCreateClaimableBalance: + if f.assetMatchedFilter(&operation.Body.CreateClaimableBalanceOp.Asset) { + return true + } + case xdr.OperationTypeCreatePassiveSellOffer: + if f.assetMatchedFilter(&operation.Body.CreatePassiveSellOfferOp.Buying) || f.assetMatchedFilter(&operation.Body.CreatePassiveSellOfferOp.Selling) { + return true + } + case xdr.OperationTypeClawback: + if f.assetMatchedFilter(&operation.Body.ClawbackOp.Asset) { + return true + } + case xdr.OperationTypePayment: + if f.assetMatchedFilter(&operation.Body.PaymentOp.Asset) { + return true + } + case xdr.OperationTypePathPaymentStrictReceive: + if f.assetMatchedFilter(&operation.Body.PathPaymentStrictReceiveOp.DestAsset) || f.assetMatchedFilter(&operation.Body.PathPaymentStrictReceiveOp.SendAsset) { + return true + } + case xdr.OperationTypePathPaymentStrictSend: + if f.assetMatchedFilter(&operation.Body.PathPaymentStrictSendOp.DestAsset) || f.assetMatchedFilter(&operation.Body.PathPaymentStrictSendOp.SendAsset) { + return true + } + } + } + return false +} + +func (f assetFilter) filterChangeTrustMatched(operation xdr.Operation) bool { + if pool, ok := operation.Body.ChangeTrustOp.Line.GetLiquidityPool(); ok { + if f.assetMatchedFilter(&pool.ConstantProduct.AssetA) || f.assetMatchedFilter(&pool.ConstantProduct.AssetB) { + return true + } + } else { + asset := operation.Body.ChangeTrustOp.Line.ToAsset() + if f.assetMatchedFilter(&asset) { + return true + } + } + return false +} + +func (f *assetFilter) assetMatchedFilter(asset *xdr.Asset) bool { + _, found := f.canonicalAssetsLookup[asset.StringCanonical()] + return found +} + +func listToMap(list []string) map[string]struct{} { + set := make(map[string]struct{}, len(list)) + for i := 0; i < len(list); i++ { + set[list[i]] = struct{}{} + } + return set +} diff --git a/services/horizon/internal/ingest/filters/asset_test.go b/services/horizon/internal/ingest/filters/asset_test.go new file mode 100644 index 0000000000..3da23bc440 --- /dev/null +++ b/services/horizon/internal/ingest/filters/asset_test.go @@ -0,0 +1,179 @@ +package filters + +import ( + "context" + "testing" + + "github.com/stretchr/testify/assert" + "github.com/stretchr/testify/require" + + "github.com/stellar/go/ingest" + "github.com/stellar/go/services/horizon/internal/db2/history" + "github.com/stellar/go/xdr" +) + +func TestAssetFilterAllowsOnMatch(t *testing.T) { + tt := assert.New(t) + ctx := context.Background() + + filterConfig := &history.AssetFilterConfig{ + Whitelist: []string{"USDC:GD6WNNTW664WH7FXC5RUMUTF7P5QSURC2IT36VOQEEGFZ4UWUEQGECAL"}, + Enabled: true, + LastModified: 1, + } + filter := NewAssetFilter() + err := filter.RefreshAssetFilter(filterConfig) + tt.NoError(err) + + result, err := filter.FilterTransaction(ctx, getAssetTestV1Tx(t, "GD6WNNTW664WH7FXC5RUMUTF7P5QSURC2IT36VOQEEGFZ4UWUEQGECAL")) + tt.NoError(err) + tt.Equal(result, true) + + result, err = filter.FilterTransaction(ctx, getAssetTestV0Tx(t, "GD6WNNTW664WH7FXC5RUMUTF7P5QSURC2IT36VOQEEGFZ4UWUEQGECAL")) + tt.NoError(err) + tt.Equal(result, true) +} + +func TestAssetFilterAllowsWhenEmptyWhitelist(t *testing.T) { + tt := assert.New(t) + ctx := context.Background() + + filterConfig := &history.AssetFilterConfig{ + Whitelist: []string{}, + Enabled: true, + LastModified: 1, + } + filter := NewAssetFilter() + err := filter.RefreshAssetFilter(filterConfig) + tt.NoError(err) + + result, err := filter.FilterTransaction(ctx, getAssetTestV1Tx(t, "GD6WNNTW664WH7FXC5RUMUTF7P5QSURC2IT36VOQEEGFZ4UWUEQGECAL")) + tt.NoError(err) + tt.Equal(result, true) + + result, err = filter.FilterTransaction(ctx, getAssetTestV0Tx(t, "GD6WNNTW664WH7FXC5RUMUTF7P5QSURC2IT36VOQEEGFZ4UWUEQGECAL")) + tt.NoError(err) + tt.Equal(result, true) +} + +func TestAssetFilterAllowsWhenDisabled(t *testing.T) { + tt := assert.New(t) + ctx := context.Background() + + filterConfig := &history.AssetFilterConfig{ + Whitelist: []string{"USDX:GD6WNNTW664WH7FXC5RUMUTF7P5QSURC2IT36VOQEEGFZ4UWUEQGECAL"}, + Enabled: false, + LastModified: 1, + } + filter := NewAssetFilter() + err := filter.RefreshAssetFilter(filterConfig) + tt.NoError(err) + + result, err := filter.FilterTransaction(ctx, getAssetTestV1Tx(t, "GD6WNNTW664WH7FXC5RUMUTF7P5QSURC2IT36VOQEEGFZ4UWUEQGECAL")) + tt.NoError(err) + // there was no match on filter rules, but since filter was disabled also, it should allow all + tt.Equal(result, true) +} + +func TestAssetFilterDoesNotAllowV1WhenNoMatch(t *testing.T) { + tt := assert.New(t) + ctx := context.Background() + + filterConfig := &history.AssetFilterConfig{ + Whitelist: []string{"USDX:GD6WNNTW664WH7FXC5RUMUTF7P5QSURC2IT36VOQEEGFZ4UWUEQGECAL"}, + Enabled: true, + LastModified: 1, + } + + filter := NewAssetFilter() + err := filter.RefreshAssetFilter(filterConfig) + tt.NoError(err) + + result, err := filter.FilterTransaction(ctx, getAssetTestV1Tx(t, "GD6WNNTW664WH7FXC5RUMUTF7P5QSURC2IT36VOQEEGFZ4UWUEQGECAL")) + tt.NoError(err) + tt.Equal(result, false) + + result, err = filter.FilterTransaction(ctx, getAssetTestV0Tx(t, "GD6WNNTW664WH7FXC5RUMUTF7P5QSURC2IT36VOQEEGFZ4UWUEQGECAL")) + tt.NoError(err) + tt.Equal(result, false) +} + +func getAssetTestV1Tx(t *testing.T, issuer string) ingest.LedgerTransaction { + var xdrAssetCode [12]byte + var xdrIssuer xdr.AccountId + copy(xdrAssetCode[:], "USDC") + require.NoError(t, xdrIssuer.SetAddress(issuer)) + + return ingest.LedgerTransaction{ + Result: xdr.TransactionResultPair{ + Result: xdr.TransactionResult{ + Result: xdr.TransactionResultResult{ + Code: xdr.TransactionResultCodeTxSuccess, + }, + }, + }, + Envelope: xdr.TransactionEnvelope{ + Type: xdr.EnvelopeTypeEnvelopeTypeTx, + V1: &xdr.TransactionV1Envelope{ + Tx: xdr.Transaction{ + Operations: []xdr.Operation{ + {Body: xdr.OperationBody{ + Type: xdr.OperationTypePayment, + PaymentOp: &xdr.PaymentOp{ + Destination: xdr.MustMuxedAddress("GD6WNNTW664WH7FXC5RUMUTF7P5QSURC2IT36VOQEEGFZ4UWUEQGECAL"), + Asset: xdr.Asset{ + Type: xdr.AssetTypeAssetTypeCreditAlphanum12, + AlphaNum12: &xdr.AlphaNum12{ + AssetCode: xdrAssetCode, + Issuer: xdrIssuer, + }, + }, + Amount: 100, + }, + }}, + }, + }, + }, + }, + } +} + +func getAssetTestV0Tx(t *testing.T, issuer string) ingest.LedgerTransaction { + var xdrAssetCode [12]byte + var xdrIssuer xdr.AccountId + copy(xdrAssetCode[:], "USDC") + require.NoError(t, xdrIssuer.SetAddress(issuer)) + + return ingest.LedgerTransaction{ + Result: xdr.TransactionResultPair{ + Result: xdr.TransactionResult{ + Result: xdr.TransactionResultResult{ + Code: xdr.TransactionResultCodeTxSuccess, + }, + }, + }, + Envelope: xdr.TransactionEnvelope{ + Type: xdr.EnvelopeTypeEnvelopeTypeTxV0, + V0: &xdr.TransactionV0Envelope{ + Tx: xdr.TransactionV0{ + Operations: []xdr.Operation{ + {Body: xdr.OperationBody{ + Type: xdr.OperationTypePayment, + PaymentOp: &xdr.PaymentOp{ + Destination: xdr.MustMuxedAddress("GD6WNNTW664WH7FXC5RUMUTF7P5QSURC2IT36VOQEEGFZ4UWUEQGECAL"), + Asset: xdr.Asset{ + Type: xdr.AssetTypeAssetTypeCreditAlphanum12, + AlphaNum12: &xdr.AlphaNum12{ + AssetCode: xdrAssetCode, + Issuer: xdrIssuer, + }, + }, + Amount: 100, + }, + }}, + }, + }, + }, + }, + } +} diff --git a/services/horizon/internal/ingest/filters/main.go b/services/horizon/internal/ingest/filters/main.go new file mode 100644 index 0000000000..94e762d0ac --- /dev/null +++ b/services/horizon/internal/ingest/filters/main.go @@ -0,0 +1,75 @@ +package filters + +import ( + "context" + "time" + + "github.com/stellar/go/services/horizon/internal/db2/history" + "github.com/stellar/go/services/horizon/internal/ingest/processors" + "github.com/stellar/go/support/log" +) + +var ( + + // the filter config cache will be checked against latest from db at most once per each of this interval. + //lint:ignore ST1011, don't need the linter warn on literal assignment + FilterConfigCheckIntervalSeconds time.Duration = 100 +) + +var ( + LOG = log.WithFields(log.F{ + "filters": "load", + }) +) + +type filtersCache struct { + assetFilter AssetFilter + accountFilter AccountFilter + lastFilterConfigCheckUnixEpoch int64 +} + +type Filters interface { + GetFilters(filterQ history.QFilter, ctx context.Context) []processors.LedgerTransactionFilterer +} + +func NewFilters() Filters { + return &filtersCache{ + assetFilter: NewAssetFilter(), + accountFilter: NewAccountFilter(), + } +} + +// Provide list of the active filters. Optimize performance by caching the list, only +// rebuild the list on expiration time interval. Method is NOT thread-safe. +func (f *filtersCache) GetFilters(filterQ history.QFilter, ctx context.Context) []processors.LedgerTransactionFilterer { + // only attempt to refresh filter config cache state at configured interval limit + if time.Now().Unix() < (f.lastFilterConfigCheckUnixEpoch + int64(FilterConfigCheckIntervalSeconds.Seconds())) { + return f.convertCacheToList() + } + + f.lastFilterConfigCheckUnixEpoch = time.Now().Unix() + + LOG.Info("expired filter config cache, refresh from db") + + if filterConfig, err := filterQ.GetAssetFilterConfig(ctx); err != nil { + LOG.Errorf("unable to refresh asset filter config %v", err) + } else { + if err := f.assetFilter.RefreshAssetFilter(&filterConfig); err != nil { + LOG.Errorf("unable to refresh asset filter config %v", err) + } + } + + if filterConfig, err := filterQ.GetAccountFilterConfig(ctx); err != nil { + LOG.Errorf("unable to refresh account filter config %v", err) + } else { + if err := f.accountFilter.RefreshAccountFilter(&filterConfig); err != nil { + LOG.Errorf("unable to refresh account filter config %v", err) + } + } + + return f.convertCacheToList() +} + +func (f *filtersCache) convertCacheToList() []processors.LedgerTransactionFilterer { + return []processors.LedgerTransactionFilterer{f.assetFilter, f.accountFilter} +} diff --git a/services/horizon/internal/ingest/filters/main_test.go b/services/horizon/internal/ingest/filters/main_test.go new file mode 100644 index 0000000000..c5f7f7c594 --- /dev/null +++ b/services/horizon/internal/ingest/filters/main_test.go @@ -0,0 +1,22 @@ +package filters + +import ( + "testing" + + "github.com/stellar/go/services/horizon/internal/db2/history" + "github.com/stellar/go/services/horizon/internal/test" +) + +func TestItGetsFilters(t *testing.T) { + tt := test.Start(t) + defer tt.Finish() + test.ResetHorizonDB(t, tt.HorizonDB) + q := &history.Q{tt.HorizonSession()} + + filtersService := NewFilters() + + ingestFilters := filtersService.GetFilters(q, tt.Ctx) + + // should be total of filters implemented in the system + tt.Assert.Len(ingestFilters, 2) +} diff --git a/services/horizon/internal/ingest/group_processors.go b/services/horizon/internal/ingest/group_processors.go index b35f940a6b..86622810b5 100644 --- a/services/horizon/internal/ingest/group_processors.go +++ b/services/horizon/internal/ingest/group_processors.go @@ -6,6 +6,7 @@ import ( "time" "github.com/stellar/go/ingest" + "github.com/stellar/go/services/horizon/internal/ingest/processors" "github.com/stellar/go/support/errors" ) @@ -82,3 +83,33 @@ func (g groupTransactionProcessors) Commit(ctx context.Context) error { } return nil } + +type groupTransactionFilterers struct { + filterers []processors.LedgerTransactionFilterer + processorsRunDurations + droppedTransactions int64 +} + +func newGroupTransactionFilterers(filterers []processors.LedgerTransactionFilterer) *groupTransactionFilterers { + return &groupTransactionFilterers{ + filterers: filterers, + processorsRunDurations: make(map[string]time.Duration), + } +} + +func (g *groupTransactionFilterers) FilterTransaction(ctx context.Context, tx ingest.LedgerTransaction) (bool, error) { + for _, f := range g.filterers { + startTime := time.Now() + include, err := f.FilterTransaction(ctx, tx) + if err != nil { + return false, errors.Wrapf(err, "error in %T.FilterTransaction", f) + } + g.AddRunDuration(fmt.Sprintf("%T", f), startTime) + if !include { + // filter out, we can return early + g.droppedTransactions++ + return false, nil + } + } + return true, nil +} diff --git a/services/horizon/internal/ingest/main.go b/services/horizon/internal/ingest/main.go index 02956f74e6..f49af5e3b1 100644 --- a/services/horizon/internal/ingest/main.go +++ b/services/horizon/internal/ingest/main.go @@ -17,6 +17,7 @@ import ( "github.com/stellar/go/ingest" "github.com/stellar/go/ingest/ledgerbackend" "github.com/stellar/go/services/horizon/internal/db2/history" + "github.com/stellar/go/services/horizon/internal/ingest/filters" "github.com/stellar/go/support/db" "github.com/stellar/go/support/errors" logpkg "github.com/stellar/go/support/log" @@ -84,6 +85,7 @@ type Config struct { DisableStateVerification bool EnableExtendedLogLedgerStats bool + ReingestEnabled bool MaxReingestRetries int ReingestRetryBackoffSeconds int @@ -91,6 +93,8 @@ type Config struct { CheckpointFrequency uint32 RoundingSlippageFilter int + + EnableIngestionFiltering bool } const ( @@ -252,8 +256,8 @@ func NewSystem(config Config) (System, error) { } historyQ := &history.Q{config.HistorySession.Clone()} - historyAdapter := newHistoryArchiveAdapter(archive) + filters := filters.NewFilters() system := &system{ cancel: cancel, @@ -273,6 +277,7 @@ func NewSystem(config Config) (System, error) { config: config, historyQ: historyQ, historyAdapter: historyAdapter, + filters: filters, }, checkpointManager: historyarchive.NewCheckpointManager(config.CheckpointFrequency), } diff --git a/services/horizon/internal/ingest/main_test.go b/services/horizon/internal/ingest/main_test.go index ae54acc0f1..370a769e67 100644 --- a/services/horizon/internal/ingest/main_test.go +++ b/services/horizon/internal/ingest/main_test.go @@ -230,6 +230,7 @@ type mockDBQ struct { mock.Mock history.MockQAccounts + history.MockQFilter history.MockQClaimableBalances history.MockQHistoryClaimableBalances history.MockQLiquidityPools @@ -243,6 +244,7 @@ type mockDBQ struct { history.MockQSigners history.MockQTransactions history.MockQTrustLines + history.MockQTxSubmissionResult } func (m *mockDBQ) Begin() error { diff --git a/services/horizon/internal/ingest/mock_filter.go b/services/horizon/internal/ingest/mock_filter.go new file mode 100644 index 0000000000..572d2173f3 --- /dev/null +++ b/services/horizon/internal/ingest/mock_filter.go @@ -0,0 +1,17 @@ +package ingest + +import ( + "context" + + "github.com/stellar/go/services/horizon/internal/db2/history" + "github.com/stellar/go/services/horizon/internal/ingest/processors" + "github.com/stretchr/testify/mock" +) + +type MockFilters struct { + mock.Mock +} + +func (m *MockFilters) GetFilters(filterQ history.QFilter, ctx context.Context) []processors.LedgerTransactionFilterer { + return []processors.LedgerTransactionFilterer{} +} diff --git a/services/horizon/internal/ingest/processor_runner.go b/services/horizon/internal/ingest/processor_runner.go index 31a08b8c97..b237751b12 100644 --- a/services/horizon/internal/ingest/processor_runner.go +++ b/services/horizon/internal/ingest/processor_runner.go @@ -7,6 +7,7 @@ import ( "github.com/stellar/go/ingest" "github.com/stellar/go/services/horizon/internal/db2/history" + "github.com/stellar/go/services/horizon/internal/ingest/filters" "github.com/stellar/go/services/horizon/internal/ingest/processors" "github.com/stellar/go/support/errors" "github.com/stellar/go/xdr" @@ -86,6 +87,7 @@ type ProcessorRunner struct { historyQ history.IngestionQ historyAdapter historyArchiveAdapterInterface logMemoryStats bool + filters filters.Filters } func (s *ProcessorRunner) SetHistoryAdapter(historyAdapter historyArchiveAdapterInterface) { @@ -147,6 +149,26 @@ func (s *ProcessorRunner) buildTransactionProcessor( }) } +func (s *ProcessorRunner) buildTransactionFilterer() *groupTransactionFilterers { + var f []processors.LedgerTransactionFilterer + if s.config.EnableIngestionFiltering { + f = append(f, s.filters.GetFilters(s.historyQ, s.ctx)...) + } + + return newGroupTransactionFilterers(f) +} + +func (s *ProcessorRunner) buildUnfilteredProcessor(ledger xdr.LedgerHeaderHistoryEntry) *groupTransactionProcessors { + // when in online mode, the submission result processor must always run (regardless of filtering) + var p []horizonTransactionProcessor + if !s.config.ReingestEnabled { + txSubProc := processors.NewTxSubmissionResultProcessor(s.historyQ, ledger) + p = append(p, txSubProc) + } + + return newGroupTransactionProcessors(p) +} + // checkIfProtocolVersionSupported checks if this Horizon version supports the // protocol version of a ledger with the given sequence number. func (s *ProcessorRunner) checkIfProtocolVersionSupported(ledgerProtocolVersion uint32) error { @@ -290,15 +312,28 @@ func (s *ProcessorRunner) RunTransactionProcessorsOnLedger(ledger xdr.LedgerClos err = errors.Wrap(err, "Error while checking for supported protocol version") return } - + header := transactionReader.GetHeader() + groupTransactionFilterers := s.buildTransactionFilterer() + groupUnfilteredProcessors := s.buildUnfilteredProcessor(header) groupTransactionProcessors := s.buildTransactionProcessor( - &ledgerTransactionStats, &tradeProcessor, transactionReader.GetHeader()) - err = processors.StreamLedgerTransactions(s.ctx, groupTransactionProcessors, transactionReader) + &ledgerTransactionStats, &tradeProcessor, header) + err = processors.StreamLedgerTransactions(s.ctx, + groupTransactionFilterers, + groupUnfilteredProcessors, + groupTransactionProcessors, + transactionReader, + ) if err != nil { err = errors.Wrap(err, "Error streaming changes from ledger") return } + err = groupUnfilteredProcessors.Commit(s.ctx) + if err != nil { + err = errors.Wrap(err, "Error committing unfiltered changes from processor") + return + } + err = groupTransactionProcessors.Commit(s.ctx) if err != nil { err = errors.Wrap(err, "Error committing changes from processor") @@ -306,7 +341,15 @@ func (s *ProcessorRunner) RunTransactionProcessorsOnLedger(ledger xdr.LedgerClos } transactionStats = ledgerTransactionStats.GetResults() + transactionStats.TransactionsFiltered = groupTransactionFilterers.droppedTransactions transactionDurations = groupTransactionProcessors.processorsRunDurations + for key, duration := range groupUnfilteredProcessors.processorsRunDurations { + transactionDurations[key] = duration + } + for key, duration := range groupTransactionFilterers.processorsRunDurations { + transactionDurations[key] = duration + } + tradeStats = tradeProcessor.GetStats() return } diff --git a/services/horizon/internal/ingest/processor_runner_test.go b/services/horizon/internal/ingest/processor_runner_test.go index 84b96cbe51..1ef3103673 100644 --- a/services/horizon/internal/ingest/processor_runner_test.go +++ b/services/horizon/internal/ingest/processor_runner_test.go @@ -57,6 +57,7 @@ func TestProcessorRunnerRunHistoryArchiveIngestionGenesis(t *testing.T) { NetworkPassphrase: network.PublicNetworkPassphrase, }, historyQ: q, + filters: &MockFilters{}, } _, err := runner.RunGenesisStateIngestion() @@ -120,6 +121,7 @@ func TestProcessorRunnerRunHistoryArchiveIngestionHistoryArchive(t *testing.T) { config: config, historyQ: q, historyAdapter: historyAdapter, + filters: &MockFilters{}, } _, err := runner.RunHistoryArchiveIngestion(63, MaxSupportedProtocolVersion, bucketListHash) @@ -154,6 +156,7 @@ func TestProcessorRunnerRunHistoryArchiveIngestionProtocolVersionNotSupported(t config: config, historyQ: q, historyAdapter: historyAdapter, + filters: &MockFilters{}, } _, err := runner.RunHistoryArchiveIngestion(100, 200, xdr.Hash{}) @@ -178,6 +181,7 @@ func TestProcessorRunnerBuildChangeProcessor(t *testing.T) { runner := ProcessorRunner{ ctx: ctx, historyQ: q, + filters: &MockFilters{}, } stats := &ingest.StatsChangeProcessor{} @@ -199,6 +203,7 @@ func TestProcessorRunnerBuildChangeProcessor(t *testing.T) { runner = ProcessorRunner{ ctx: ctx, historyQ: q, + filters: &MockFilters{}, } processor = buildChangeProcessor(runner.historyQ, stats, historyArchiveSource, 456) @@ -250,6 +255,63 @@ func TestProcessorRunnerBuildTransactionProcessor(t *testing.T) { assert.IsType(t, &processors.TransactionProcessor{}, processor.processors[6]) } +func TestProcessorRunnerWithFilterEnabled(t *testing.T) { + ctx := context.Background() + maxBatchSize := 100000 + + config := Config{ + NetworkPassphrase: network.PublicNetworkPassphrase, + EnableIngestionFiltering: true, + } + + q := &mockDBQ{} + defer mock.AssertExpectationsForObjects(t, q) + + ledger := xdr.LedgerCloseMeta{ + V0: &xdr.LedgerCloseMetaV0{ + LedgerHeader: xdr.LedgerHeaderHistoryEntry{ + Header: xdr.LedgerHeader{ + BucketListHash: xdr.Hash([32]byte{0, 1, 2}), + }, + }, + }, + } + + // Batches + mockAccountSignersBatchInsertBuilder := &history.MockAccountSignersBatchInsertBuilder{} + defer mock.AssertExpectationsForObjects(t, mockAccountSignersBatchInsertBuilder) + q.MockQSigners.On("NewAccountSignersBatchInsertBuilder", maxBatchSize). + Return(mockAccountSignersBatchInsertBuilder).Once() + + mockOperationsBatchInsertBuilder := &history.MockOperationsBatchInsertBuilder{} + defer mock.AssertExpectationsForObjects(t, mockOperationsBatchInsertBuilder) + mockOperationsBatchInsertBuilder.On("Exec", ctx).Return(nil).Once() + q.MockQOperations.On("NewOperationBatchInsertBuilder", maxBatchSize). + Return(mockOperationsBatchInsertBuilder).Twice() + + mockTransactionsBatchInsertBuilder := &history.MockTransactionsBatchInsertBuilder{} + defer mock.AssertExpectationsForObjects(t, mockTransactionsBatchInsertBuilder) + mockTransactionsBatchInsertBuilder.On("Exec", ctx).Return(nil).Once() + q.MockQTransactions.On("NewTransactionBatchInsertBuilder", maxBatchSize). + Return(mockTransactionsBatchInsertBuilder).Twice() + + q.MockQLedgers.On("InsertLedger", ctx, ledger.V0.LedgerHeader, 0, 0, 0, 0, CurrentVersion). + Return(int64(1), nil).Once() + + q.MockQTxSubmissionResult.On("SetTxSubmissionResults", ctx, []ingest.LedgerTransaction(nil), uint32(0)). + Return(int64(0), nil).Once() + + runner := ProcessorRunner{ + ctx: ctx, + config: config, + historyQ: q, + filters: &MockFilters{}, + } + + _, err := runner.RunAllProcessorsOnLedger(ledger) + assert.NoError(t, err) +} + func TestProcessorRunnerRunAllProcessorsOnLedger(t *testing.T) { ctx := context.Background() maxBatchSize := 100000 @@ -292,10 +354,14 @@ func TestProcessorRunnerRunAllProcessorsOnLedger(t *testing.T) { q.MockQLedgers.On("InsertLedger", ctx, ledger.V0.LedgerHeader, 0, 0, 0, 0, CurrentVersion). Return(int64(1), nil).Once() + q.MockQTxSubmissionResult.On("SetTxSubmissionResults", ctx, []ingest.LedgerTransaction(nil), uint32(0)). + Return(int64(0), nil).Once() + runner := ProcessorRunner{ ctx: ctx, config: config, historyQ: q, + filters: &MockFilters{}, } _, err := runner.RunAllProcessorsOnLedger(ledger) @@ -344,6 +410,7 @@ func TestProcessorRunnerRunAllProcessorsOnLedgerProtocolVersionNotSupported(t *t ctx: ctx, config: config, historyQ: q, + filters: &MockFilters{}, } _, err := runner.RunAllProcessorsOnLedger(ledger) diff --git a/services/horizon/internal/ingest/processors/change_processors.go b/services/horizon/internal/ingest/processors/change_processors.go index 6c939288b8..4c5ab57816 100644 --- a/services/horizon/internal/ingest/processors/change_processors.go +++ b/services/horizon/internal/ingest/processors/change_processors.go @@ -16,8 +16,14 @@ type LedgerTransactionProcessor interface { ProcessTransaction(ctx context.Context, transaction ingest.LedgerTransaction) error } +type LedgerTransactionFilterer interface { + FilterTransaction(ctx context.Context, transaction ingest.LedgerTransaction) (bool, error) +} + func StreamLedgerTransactions( ctx context.Context, + txFilterer LedgerTransactionFilterer, + unfilteredTxProcessor LedgerTransactionProcessor, txProcessor LedgerTransactionProcessor, reader *ingest.LedgerTransactionReader, ) error { @@ -29,6 +35,26 @@ func StreamLedgerTransactions( if err != nil { return errors.Wrap(err, "could not read transaction") } + include, err := txFilterer.FilterTransaction(ctx, tx) + if err != nil { + return errors.Wrapf( + err, + "could not filter transaction %v", + tx.Index, + ) + } + if err = unfilteredTxProcessor.ProcessTransaction(ctx, tx); err != nil { + return errors.Wrapf( + err, + "could not process transaction %v", + tx.Index, + ) + } + if !include { + log.Infof("Filters did not find match on transaction, dropping this tx with hash %v", tx.Result.TransactionHash.HexString()) + continue + } + if err = txProcessor.ProcessTransaction(ctx, tx); err != nil { return errors.Wrapf( err, diff --git a/services/horizon/internal/ingest/processors/participants_processor.go b/services/horizon/internal/ingest/processors/participants_processor.go index 6b2bedb2f5..517c253d92 100644 --- a/services/horizon/internal/ingest/processors/participants_processor.go +++ b/services/horizon/internal/ingest/processors/participants_processor.go @@ -139,56 +139,13 @@ func participantsForMeta( return participants, nil } -func participantsForTransaction( - sequence uint32, - transaction ingest.LedgerTransaction, -) ([]xdr.AccountId, error) { - participants := []xdr.AccountId{ - transaction.Envelope.SourceAccount().ToAccountId(), - } - if transaction.Envelope.IsFeeBump() { - participants = append(participants, transaction.Envelope.FeeBumpAccount().ToAccountId()) - } - - p, err := participantsForMeta(transaction.UnsafeMeta) - if err != nil { - return nil, err - } - participants = append(participants, p...) - - p, err = participantsForChanges(transaction.FeeChanges) - if err != nil { - return nil, err - } - participants = append(participants, p...) - - for opi, op := range transaction.Envelope.Operations() { - operation := transactionOperationWrapper{ - index: uint32(opi), - transaction: transaction, - operation: op, - ledgerSequence: sequence, - } - - p, err := operation.Participants() - if err != nil { - return nil, errors.Wrapf( - err, "could not determine operation %v participants", operation.ID(), - ) - } - participants = append(participants, p...) - } - - return dedupeParticipants(participants), nil -} - func (p *ParticipantsProcessor) addTransactionParticipants( participantSet map[string]participant, sequence uint32, transaction ingest.LedgerTransaction, ) error { transactionID := toid.New(int32(sequence), int32(transaction.Index), 0).ToInt64() - transactionParticipants, err := participantsForTransaction( + transactionParticipants, err := ParticipantsForTransaction( sequence, transaction, ) @@ -293,3 +250,46 @@ func (p *ParticipantsProcessor) Commit(ctx context.Context) (err error) { return err } + +func ParticipantsForTransaction( + sequence uint32, + transaction ingest.LedgerTransaction, +) ([]xdr.AccountId, error) { + participants := []xdr.AccountId{ + transaction.Envelope.SourceAccount().ToAccountId(), + } + if transaction.Envelope.IsFeeBump() { + participants = append(participants, transaction.Envelope.FeeBumpAccount().ToAccountId()) + } + + p, err := participantsForMeta(transaction.UnsafeMeta) + if err != nil { + return nil, err + } + participants = append(participants, p...) + + p, err = participantsForChanges(transaction.FeeChanges) + if err != nil { + return nil, err + } + participants = append(participants, p...) + + for opi, op := range transaction.Envelope.Operations() { + operation := transactionOperationWrapper{ + index: uint32(opi), + transaction: transaction, + operation: op, + ledgerSequence: sequence, + } + + p, err := operation.Participants() + if err != nil { + return nil, errors.Wrapf( + err, "could not determine operation %v participants", operation.ID(), + ) + } + participants = append(participants, p...) + } + + return dedupeParticipants(participants), nil +} diff --git a/services/horizon/internal/ingest/processors/participants_test.go b/services/horizon/internal/ingest/processors/participants_test.go index 73684c0555..24a1fb1d7d 100644 --- a/services/horizon/internal/ingest/processors/participants_test.go +++ b/services/horizon/internal/ingest/processors/participants_test.go @@ -35,7 +35,7 @@ func TestParticipantsForTransaction(t *testing.T) { ), ) - particpants, err := participantsForTransaction( + particpants, err := ParticipantsForTransaction( 3, ingest.LedgerTransaction{ Index: 1, diff --git a/services/horizon/internal/ingest/processors/stats_ledger_transaction_processor.go b/services/horizon/internal/ingest/processors/stats_ledger_transaction_processor.go index cec7b5ff54..4853152199 100644 --- a/services/horizon/internal/ingest/processors/stats_ledger_transaction_processor.go +++ b/services/horizon/internal/ingest/processors/stats_ledger_transaction_processor.go @@ -19,6 +19,7 @@ type StatsLedgerTransactionProcessorResults struct { Transactions int64 TransactionsSuccessful int64 TransactionsFailed int64 + TransactionsFiltered int64 Operations int64 OperationsInSuccessful int64 @@ -131,6 +132,7 @@ func (stats *StatsLedgerTransactionProcessorResults) Map() map[string]interface{ "stats_transactions": stats.Transactions, "stats_transactions_successful": stats.TransactionsSuccessful, "stats_transactions_failed": stats.TransactionsFailed, + "stats_transactions_filtered": stats.TransactionsFiltered, "stats_operations": stats.Operations, "stats_operations_in_successful": stats.OperationsInSuccessful, diff --git a/services/horizon/internal/ingest/processors/stats_ledger_transaction_processor_test.go b/services/horizon/internal/ingest/processors/stats_ledger_transaction_processor_test.go index ef4f15ce61..f2bc2a5040 100644 --- a/services/horizon/internal/ingest/processors/stats_ledger_transaction_processor_test.go +++ b/services/horizon/internal/ingest/processors/stats_ledger_transaction_processor_test.go @@ -129,10 +129,12 @@ func TestStatsLedgerTransactionProcessor(t *testing.T) { })) results := processor.GetResults() + results.TransactionsFiltered = 1 assert.Equal(t, int64(2), results.Transactions) assert.Equal(t, int64(1), results.TransactionsSuccessful) assert.Equal(t, int64(1), results.TransactionsFailed) + assert.Equal(t, int64(1), results.TransactionsFiltered) assert.Equal(t, int64(21*2), results.Operations) assert.Equal(t, int64(21), results.OperationsInSuccessful) diff --git a/services/horizon/internal/ingest/processors/txsub_result_processor.go b/services/horizon/internal/ingest/processors/txsub_result_processor.go new file mode 100644 index 0000000000..9b7aefe9c1 --- /dev/null +++ b/services/horizon/internal/ingest/processors/txsub_result_processor.go @@ -0,0 +1,39 @@ +package processors + +import ( + "context" + "time" + + "github.com/stellar/go/ingest" + "github.com/stellar/go/services/horizon/internal/db2/history" + "github.com/stellar/go/xdr" +) + +type TxSubmissionResultProcessor struct { + txSubmissionResultQ history.QTxSubmissionResult + ledger xdr.LedgerHeaderHistoryEntry + txs []ingest.LedgerTransaction +} + +func NewTxSubmissionResultProcessor( + txSubmissionResultQ history.QTxSubmissionResult, + ledger xdr.LedgerHeaderHistoryEntry, +) *TxSubmissionResultProcessor { + return &TxSubmissionResultProcessor{ + ledger: ledger, + txSubmissionResultQ: txSubmissionResultQ, + } +} + +func (p *TxSubmissionResultProcessor) ProcessTransaction(ctx context.Context, transaction ingest.LedgerTransaction) (err error) { + p.txs = append(p.txs, transaction) + + return nil +} + +func (p *TxSubmissionResultProcessor) Commit(ctx context.Context) error { + seq := uint32(p.ledger.Header.LedgerSeq) + closeTime := time.Unix(int64(p.ledger.Header.ScpValue.CloseTime), 0).UTC() + _, err := p.txSubmissionResultQ.SetTxSubmissionResults(ctx, p.txs, seq, closeTime) + return err +} diff --git a/services/horizon/internal/ingest/testdata/test_asset_filter_params.json b/services/horizon/internal/ingest/testdata/test_asset_filter_params.json new file mode 100644 index 0000000000..dbd7694b08 --- /dev/null +++ b/services/horizon/internal/ingest/testdata/test_asset_filter_params.json @@ -0,0 +1,11 @@ +{ + "CanonicalAssetList": [ + "BITC:ABC123456", + "DOGT:DEF123456" + ], + "AssetIssuerList": [], + "AssetCodeList ": [], + "ResolveLiquidityPoolAsAsset": true, + "TraverseEffects": false, + "Activated": true +} diff --git a/services/horizon/internal/init.go b/services/horizon/internal/init.go index c2b438d839..5ee6636a67 100644 --- a/services/horizon/internal/init.go +++ b/services/horizon/internal/init.go @@ -103,6 +103,7 @@ func initIngester(app *App) { DisableStateVerification: app.config.IngestDisableStateVerification, EnableExtendedLogLedgerStats: app.config.IngestEnableExtendedLogLedgerStats, RoundingSlippageFilter: app.config.RoundingSlippageFilter, + EnableIngestionFiltering: app.config.EnableIngestionFiltering, }) if err != nil { diff --git a/services/horizon/internal/integration/ingestion_filtering_test.go b/services/horizon/internal/integration/ingestion_filtering_test.go new file mode 100644 index 0000000000..f9e0a87e27 --- /dev/null +++ b/services/horizon/internal/integration/ingestion_filtering_test.go @@ -0,0 +1,167 @@ +package integration + +import ( + "strconv" + "testing" + "time" + + "github.com/stellar/go/clients/horizonclient" + hProtocol "github.com/stellar/go/protocols/horizon" + "github.com/stellar/go/services/horizon/internal/ingest/filters" + "github.com/stellar/go/services/horizon/internal/test/integration" + "github.com/stellar/go/txnbuild" + "github.com/stretchr/testify/assert" +) + +func TestFilteringAccountWhiteList(t *testing.T) { + tt := assert.New(t) + const adminPort uint16 = 6000 + itest := integration.NewTest(t, integration.Config{ + HorizonParameters: map[string]string{ + "admin-port": strconv.Itoa(int(adminPort)), + "enable-ingestion-filtering": "true", + }, + }) + + fullKeys, accounts := itest.CreateAccounts(2, "10000") + whitelistedAccount := accounts[0] + whitelistedAccountKey := fullKeys[0] + nonWhitelistedAccount := accounts[1] + nonWhitelistedAccountKey := fullKeys[1] + enabled := true + + // all assets are allowed by default because the asset filter config is empty. + defaultAllowedAsset := txnbuild.CreditAsset{Code: "PTS", Issuer: itest.Master().Address()} + itest.MustEstablishTrustline(whitelistedAccountKey, whitelistedAccount, defaultAllowedAsset) + itest.MustEstablishTrustline(nonWhitelistedAccountKey, nonWhitelistedAccount, defaultAllowedAsset) + + // assert that by system default, filters with no rules yet, allow all first + txResp := itest.MustSubmitOperations(itest.MasterAccount(), itest.Master(), + &txnbuild.Payment{ + Destination: nonWhitelistedAccount.GetAccountID(), + Amount: "10", + Asset: defaultAllowedAsset, + }, + ) + + txResp, err := itest.Client().TransactionDetail(txResp.Hash) + tt.NoError(err) + + // Setup a whitelisted account rule, force refresh of filter configs to be quick + filters.FilterConfigCheckIntervalSeconds = 1 + + expectedAccountFilter := hProtocol.AccountFilterConfig{ + Whitelist: []string{whitelistedAccount.GetAccountID()}, + Enabled: &enabled, + } + err = itest.AdminClient().SetIngestionAccountFilter(expectedAccountFilter) + tt.NoError(err) + + accountFilter, err := itest.AdminClient().GetIngestionAccountFilter() + tt.NoError(err) + + tt.ElementsMatch(expectedAccountFilter.Whitelist, accountFilter.Whitelist) + tt.Equal(expectedAccountFilter.Enabled, accountFilter.Enabled) + + // Ensure the latest filter configs are reloaded by the ingestion state machine processor + time.Sleep(time.Duration(filters.FilterConfigCheckIntervalSeconds) * time.Second) + + // Make sure that when using a non-whitelisted account, the transaction is not stored + txResp = itest.MustSubmitOperations(itest.MasterAccount(), itest.Master(), + &txnbuild.Payment{ + Destination: nonWhitelistedAccount.GetAccountID(), + Amount: "10", + Asset: defaultAllowedAsset, + }, + ) + _, err = itest.Client().TransactionDetail(txResp.Hash) + tt.True(horizonclient.IsNotFoundError(err)) + + // Make sure that when using a whitelisted account, the transaction is stored + txResp = itest.MustSubmitOperations(itest.MasterAccount(), itest.Master(), + &txnbuild.Payment{ + Destination: whitelistedAccount.GetAccountID(), + Amount: "10", + Asset: defaultAllowedAsset, + }, + ) + _, err = itest.Client().TransactionDetail(txResp.Hash) + tt.NoError(err) +} + +func TestFilteringAssetWhiteList(t *testing.T) { + tt := assert.New(t) + const adminPort uint16 = 6000 + itest := integration.NewTest(t, integration.Config{ + HorizonParameters: map[string]string{ + "admin-port": strconv.Itoa(int(adminPort)), + "enable-ingestion-filtering": "true", + }, + }) + + fullKeys, accounts := itest.CreateAccounts(1, "10000") + defaultAllowedAccount := accounts[0] + defaultAllowedAccountKey := fullKeys[0] + + whitelistedAsset := txnbuild.CreditAsset{Code: "PTS", Issuer: itest.Master().Address()} + itest.MustEstablishTrustline(defaultAllowedAccountKey, defaultAllowedAccount, whitelistedAsset) + + nonWhitelistedAsset := txnbuild.CreditAsset{Code: "SEK", Issuer: itest.Master().Address()} + itest.MustEstablishTrustline(defaultAllowedAccountKey, defaultAllowedAccount, nonWhitelistedAsset) + enabled := true + + // assert that by system default, filters with no rules yet, allow all first + txResp := itest.MustSubmitOperations(itest.MasterAccount(), itest.Master(), + &txnbuild.Payment{ + Destination: defaultAllowedAccount.GetAccountID(), + Amount: "10", + Asset: nonWhitelistedAsset, + }, + ) + + _, err := itest.Client().TransactionDetail(txResp.Hash) + tt.NoError(err) + + // Setup a whitelisted asset rule, force refresh of filters to be quick + filters.FilterConfigCheckIntervalSeconds = 1 + + asset, err := whitelistedAsset.ToXDR() + tt.NoError(err) + expectedAssetFilter := hProtocol.AssetFilterConfig{ + Whitelist: []string{asset.StringCanonical()}, + Enabled: &enabled, + } + err = itest.AdminClient().SetIngestionAssetFilter(expectedAssetFilter) + tt.NoError(err) + + assetFilter, err := itest.AdminClient().GetIngestionAssetFilter() + tt.NoError(err) + + tt.ElementsMatch(expectedAssetFilter.Whitelist, assetFilter.Whitelist) + tt.Equal(expectedAssetFilter.Enabled, assetFilter.Enabled) + + // Ensure the latest filter configs are reloaded by the ingestion state machine processor + time.Sleep(time.Duration(filters.FilterConfigCheckIntervalSeconds) * time.Second) + + // Make sure that when using a non-whitelisted asset, the transaction is not stored + txResp = itest.MustSubmitOperations(itest.MasterAccount(), itest.Master(), + &txnbuild.Payment{ + Destination: defaultAllowedAccount.GetAccountID(), + Amount: "10", + Asset: nonWhitelistedAsset, + }, + ) + _, err = itest.Client().TransactionDetail(txResp.Hash) + tt.True(horizonclient.IsNotFoundError(err)) + + // Make sure that when using a whitelisted asset, the transaction is stored + txResp = itest.MustSubmitOperations(itest.MasterAccount(), itest.Master(), + &txnbuild.Payment{ + Destination: defaultAllowedAccount.GetAccountID(), + Amount: "10", + Asset: whitelistedAsset, + }, + ) + _, err = itest.Client().TransactionDetail(txResp.Hash) + tt.NoError(err) +} diff --git a/services/horizon/internal/test/integration/integration.go b/services/horizon/internal/test/integration/integration.go index 92e8740d59..eb88094782 100644 --- a/services/horizon/internal/test/integration/integration.go +++ b/services/horizon/internal/test/integration/integration.go @@ -84,8 +84,9 @@ type Test struct { horizonConfig horizon.Config environment *EnvironmentManager - horizonClient *sdk.Client - coreClient *stellarcore.Client + horizonClient *sdk.Client + horizonAdminClient *sdk.AdminClient + coreClient *stellarcore.Client app *horizon.App appStopped chan struct{} @@ -96,11 +97,17 @@ type Test struct { } func NewTestForRemoteHorizon(t *testing.T, horizonURL string, passPhrase string, masterKey *keypair.Full) *Test { + adminClient, err := sdk.NewAdminClient(0, "", 0) + if err != nil { + t.Fatal(err) + } + return &Test{ - t: t, - horizonClient: &sdk.Client{HorizonURL: horizonURL}, - masterKey: masterKey, - passPhrase: passPhrase, + t: t, + horizonClient: &sdk.Client{HorizonURL: horizonURL}, + horizonAdminClient: adminClient, + masterKey: masterKey, + passPhrase: passPhrase, } } @@ -370,13 +377,23 @@ func (i *Test) StartHorizon() error { } horizonPort := "8000" - if port, ok := merged["--port"]; ok { + if port, ok := merged["port"]; ok { horizonPort = port } + adminPort := uint16(6060) + if port, ok := merged["admin-port"]; ok { + if cmdAdminPort, parseErr := strconv.ParseInt(port, 0, 16); parseErr == nil { + adminPort = uint16(cmdAdminPort) + } + } i.horizonConfig = *config i.horizonClient = &sdk.Client{ HorizonURL: fmt.Sprintf("http://%s:%s", hostname, horizonPort), } + i.horizonAdminClient, err = sdk.NewAdminClient(adminPort, "", 0) + if err != nil { + return errors.Wrap(err, "cannot initialize Horizon admin client") + } done := make(chan struct{}) go func() { @@ -481,6 +498,11 @@ func (i *Test) Client() *sdk.Client { return i.horizonClient } +// Client returns horizon.Client connected to started Horizon instance. +func (i *Test) AdminClient() *sdk.AdminClient { + return i.horizonAdminClient +} + // Horizon returns the horizon.App instance for the current integration test func (i *Test) Horizon() *horizon.App { return i.app diff --git a/services/horizon/internal/test/scenarios/base-horizon.sql b/services/horizon/internal/test/scenarios/base-horizon.sql index cf45ee8def..8a8d009e01 100644 --- a/services/horizon/internal/test/scenarios/base-horizon.sql +++ b/services/horizon/internal/test/scenarios/base-horizon.sql @@ -776,7 +776,10 @@ INSERT INTO gorp_migrations VALUES ('48_rebuild_trade_aggregations.sql', '2021-1 INSERT INTO gorp_migrations VALUES ('49_add_brin_index_trade_aggregations.sql', '2021-12-02 01:33:33.43274+00'); INSERT INTO gorp_migrations VALUES ('50_liquidity_pools.sql', '2021-12-02 01:33:33.471893+00'); INSERT INTO gorp_migrations VALUES ('51_remove_ht_unused_indexes.sql', '2021-12-02 01:33:33.47903+00'); - +INSERT INTO gorp_migrations VALUES ('52_add_trade_type_index.sql', '2021-12-02 01:33:33.47903+00'); +INSERT INTO gorp_migrations VALUES ('53_add_trades_rounding_slippage.sql', '2021-12-02 01:33:33.47903+00'); +INSERT INTO gorp_migrations VALUES ('54_tx_preconditions_and_account_fields.sql', '2021-12-02 01:33:33.47903+00'); +INSERT INTO gorp_migrations VALUES ('55_filter_rules.sql', '2022-01-02 01:33:33.47903+00'); -- @@ -1524,10 +1527,55 @@ ALTER TABLE history_trades DROP offer_id, CREATE INDEX htrd_by_base_liquidity_pool_id ON history_trades USING BTREE(base_liquidity_pool_id); CREATE INDEX htrd_by_counter_liquidity_pool_id ON history_trades USING BTREE(counter_liquidity_pool_id); --- mgiration 51 +-- migration 51 DROP INDEX IF EXISTS by_account; DROP INDEX IF EXISTS by_fee_account; +-- migration 52 +ALTER TABLE history_trades ADD trade_type smallint DEFAULT 1 CHECK(trade_type > 0); +UPDATE history_trades SET trade_type = 2 WHERE base_liquidity_pool_id IS NOT NULL OR counter_liquidity_pool_id IS NOT NULL; +CREATE INDEX htrd_by_trade_type ON history_trades USING BTREE(trade_type, history_operation_id, "order"); + +-- migration 54 + +ALTER TABLE accounts ADD sequence_ledger integer; +ALTER TABLE accounts ADD sequence_time bigint; + +-- adjust it *ever again*. +ALTER TABLE accounts_signers + ALTER COLUMN signer TYPE text; + +-- migration 55 + +CREATE TABLE account_filter_rules ( + enabled bool NOT NULL default false, + whitelist varchar[] NOT NULL, + last_modified bigint NOT NULL +); + +CREATE TABLE asset_filter_rules ( + enabled bool NOT NULL default false, + whitelist varchar[] NOT NULL, + last_modified bigint NOT NULL +); + +-- insert the default disabled state for each supported filter implementation +INSERT INTO account_filter_rules VALUES (false, '{}', 0); +INSERT INTO asset_filter_rules VALUES (false, '{}', 0); + +CREATE TABLE txsub_results ( + transaction_hash varchar(64) NOT NULL UNIQUE, + inner_transaction_hash varchar(64), + tx_result text, -- serialized history.Transaction + submitted_at timestamp NOT NULL DEFAULT NOW() +); + +INSERT INTO txsub_results +VALUES ( + '2374e99349b9ef7dba9a5db3339b78fda8f34777b1af33ba468ad5c0df946d4d', + NULL, + '{ "TxResult": "AAAAAAAAAGQAAAAAAAAAAQAAAAAAAAAAAAAAAAAAAAA=" }', + '2019-06-03 18:28:47.032496+02'); -- -- PostgreSQL database dump complete diff --git a/services/horizon/internal/test/scenarios/bindata.go b/services/horizon/internal/test/scenarios/bindata.go index f68b78caed..396b6b809f 100644 --- a/services/horizon/internal/test/scenarios/bindata.go +++ b/services/horizon/internal/test/scenarios/bindata.go @@ -3,9 +3,9 @@ // account_merge-core.sql (26.849kB) // account_merge-horizon.sql (36.967kB) // base-core.sql (29.682kB) -// base-horizon.sql (58.384kB) +// base-horizon.sql (60.521kB) // failed_transactions-core.sql (38.723kB) -// failed_transactions-horizon.sql (55.396kB) +// failed_transactions-horizon.sql (59.52kB) // ingest_asset_stats-core.sql (61.38kB) // ingest_asset_stats-horizon.sql (88.329kB) // kahuna-core.sql (232.639kB) @@ -150,7 +150,7 @@ func baseCoreSql() (*asset, error) { return a, nil } -var _baseHorizonSql = []byte("\x1f\x8b\x08\x00\x00\x00\x00\x00\x00\xff\xd4\x7d\x79\x6f\xe2\xc8\xd3\xf0\xff\xf3\x29\x5a\xa3\x95\x92\x3c\x93\xd9\xf8\xc6\xce\x3c\xf3\x93\x0c\x98\x40\x42\x20\xe1\xc8\xb5\x5a\x59\x6d\xbb\x0d\x4e\x8c\x4d\x6c\x13\x60\x56\xcf\x77\x7f\xe5\x0b\x6c\xe3\x13\xc8\xfc\xf6\x8d\x56\xb3\x80\xab\xeb\xea\xea\xea\xaa\xee\xea\xf6\xf7\xef\x5f\xbe\x7f\x07\x77\xa6\xed\x4c\x2c\x34\xbc\xef\x02\x05\x3a\x50\x82\x36\x02\xca\x62\x36\xff\xf2\xfd\xfb\x17\xf7\x79\x73\x31\x9b\x23\x05\xa8\x96\x39\xdb\x02\x7c\x20\xcb\xd6\x4c\x03\x70\x7f\x32\x7f\xe2\x11\x28\x69\x0d\xe6\x13\xd1\x6d\x9e\x00\xf9\x32\x14\x46\xc0\x76\xa0\x83\x66\xc8\x70\x44\x47\x9b\x21\x73\xe1\x80\x9f\x00\xfb\xe1\x3d\xd2\x4d\xf9\x6d\xf7\x57\x59\xd7\x5c\x68\x64\xc8\xa6\xa2\x19\x13\xf0\x13\x9c\x8c\x47\x2d\xf6\xe4\x47\x88\xce\x50\xa0\xa5\x88\xb2\x69\xa8\xa6\x35\xd3\x8c\x89\x68\x3b\x96\x66\x4c\x6c\xf0\x13\x98\x46\x80\x63\x8a\xe4\x37\x51\x5d\x18\xb2\xa3\x99\x86\x28\x99\x8a\x86\xdc\xe7\x2a\xd4\x6d\x14\x23\x33\xd3\x0c\x71\x86\x6c\x1b\x4e\x3c\x80\x25\xb4\x0c\xcd\x98\xfc\x08\x78\x47\xd0\x92\xa7\xe2\x1c\x3a\x53\xf0\x13\xcc\x17\x92\xae\xc9\xe7\xae\xb0\x32\x74\xa0\x6e\xba\x60\x7c\x77\x24\x0c\xc0\x88\xaf\x77\x05\xd0\x69\x01\xe1\xa9\x33\x1c\x0d\x41\xbf\xd7\x7d\x0e\xe0\xff\x9c\x6a\xb6\x63\x5a\x6b\xd1\xb1\xa0\x82\x6c\xd0\x1c\xf4\xef\x40\xa3\xdf\x1b\x8e\x06\x7c\xa7\x37\x8a\x34\x8a\x03\x8a\xb2\xb9\x30\x1c\x64\x89\xd0\xb6\x91\x23\x6a\x8a\xa8\xbe\xa1\xf5\x8f\xdf\x41\x50\xf6\x3e\xfd\x0e\x92\xae\x5d\xfd\x3e\x01\x7d\x6a\xd5\xa5\xf3\x19\x74\x0d\x39\x8f\x58\x04\x6a\x8b\xdc\x03\xef\xf4\x9a\xc2\x53\x04\x32\x40\xeb\x58\x0b\xdb\x11\x75\xcd\x70\x59\x5b\x8b\xce\x7a\x8e\x44\xd9\x54\x90\xa8\xd9\xf6\x02\x59\x95\x1a\xef\xd1\x64\xab\x88\xa2\x66\x50\x41\x22\x52\x55\x24\x3b\x5e\x43\xd3\x52\x90\x25\x4a\xa6\xf9\x96\xdf\xd0\xd6\x26\x06\xb2\xa2\xb4\xf2\xe1\x4d\x55\x0d\xc0\x6d\xa4\xeb\xee\xc0\xf6\x54\x5a\xa5\x51\x91\x0a\xb6\xd0\x3a\xb4\x1d\x71\x66\x2a\x9a\xaa\x21\x45\xd4\x91\x32\x29\xdf\x56\x5a\xac\x4b\x72\xa7\x19\x0a\x5a\x89\x11\x33\x34\x6c\xe8\xb9\x24\x5b\x34\x8d\x42\xcd\xc7\x5b\x9b\x73\x64\xc1\x4d\x5b\xd7\x5a\x0e\x68\xbd\xe5\xe4\x20\x2e\xaa\xb5\xf5\xb5\xec\x35\xb4\xd1\xfb\x02\x19\x72\x25\x11\x22\xcd\xe7\x16\xfa\xd0\xcc\x85\x1d\xfc\x26\x4e\xa1\x3d\xdd\x13\xd5\xe1\x18\xb4\xd9\xdc\xb4\x5c\xc7\x19\xcc\x7e\xfb\xa2\xd9\x57\x97\xb2\x6e\xda\x48\x11\x61\x25\x5b\x0c\xc7\xf3\x1e\xa6\x14\x0c\xe6\x3d\x98\x8e\xb6\x84\x8a\x62\x21\xdb\xce\x6f\x3e\x75\x2c\xc5\x8b\x10\x44\xdd\x34\xdf\x16\xf3\x12\xd0\xf3\x22\x96\x7c\x28\xa8\x59\x15\x11\x87\xd3\x63\xe9\x06\xae\xab\x74\x7d\x46\x39\xd0\x10\xfd\x1e\x4d\x4a\x79\xd7\xb0\x91\x37\x09\x56\x20\x12\x9d\x34\x8b\x5a\xcc\xdd\x06\x53\xa7\xb0\x07\xec\x98\x03\x72\xa7\xaf\xe2\x16\xc1\x38\x2d\x03\x6c\xfa\x7c\x98\x85\x80\x9a\xed\x88\xce\x4a\x9c\x17\xa3\x74\x21\xcd\x79\x59\x48\x54\x16\x2c\x9c\x4d\xf3\x81\xd1\x6a\x2e\x46\xa3\x8b\x92\xf3\x7d\x4a\x33\x37\xbc\xc8\x6f\x24\xad\x4b\x4d\x86\xae\x7e\x0b\x3d\x66\xd9\x89\xdf\x67\xb2\xa4\x54\x1b\xe0\x62\x59\x36\xee\x46\x33\x54\xdd\x9b\xb4\x44\x05\xd9\x8e\x66\x78\x9f\x4b\xb6\x9d\x9a\x33\x24\x2a\xe6\x0c\x6a\x65\x5b\xb8\x09\x53\x34\xcc\x34\xe0\x0c\x95\x09\x33\x23\xf1\x59\x4e\x98\x19\x8d\xe2\xe6\x25\x03\x58\x3f\x74\xc9\x41\x1a\xc4\x36\x65\xf1\xbd\xa1\xb5\xf8\x01\xf5\x05\x12\x5d\xbf\x8e\x72\x10\x27\x20\x4b\x53\x48\x09\x99\xc4\x39\xb4\x1c\x4d\xd6\xe6\xd0\xc8\x8d\xc3\x8b\x9a\x56\xe6\x61\x13\xf2\x54\xe5\x20\xbd\x61\x65\xfa\x9e\xc5\x97\xa1\xe7\x03\x7e\x3a\x7e\x7f\x04\x7a\x99\x8a\xff\xd1\xcb\x5c\x82\x2c\xce\x1b\xc1\x62\x49\x0e\x26\xa6\x35\x17\x67\xda\x24\x88\x28\x73\x58\x48\x40\x96\x96\x31\xe1\x03\x73\x28\x24\xbd\x65\x59\x0a\xd5\x93\xc3\xd2\x98\x43\x87\x12\x24\x52\x79\xe8\x13\xa0\x95\x69\x94\xc1\x5d\x99\x6f\xd7\x11\x96\x41\xec\x39\xcc\x3c\xec\x65\x9d\x82\xdf\xba\xd1\xef\x8e\x6f\x7b\x40\x53\x7c\xda\x4d\xa1\xc5\x8f\xbb\xa3\x92\xb8\x33\x06\xfb\x11\x30\x07\xc3\x2c\x1f\x93\xf7\x2d\x03\x51\xc4\xf3\xe7\x03\xfa\xde\x3c\x1f\x26\xe1\x98\xf3\x81\xd3\x12\xd8\xa0\xc5\x50\xb8\x1f\x0b\xbd\xc6\x1e\xbd\xe5\x4e\x8d\x36\x7a\xaf\x4c\x39\x86\xa4\x74\x6b\x05\x95\x49\x35\xe0\x64\xe2\x5a\xc0\x26\x2b\x74\x8a\x63\xc8\xb0\x99\xb4\x90\xdf\x90\x13\xcf\x0e\x4a\xb1\x25\x32\x18\x86\x61\x41\x8b\xd6\xb8\xd7\x18\x75\xfa\xbd\x94\xde\x37\xc5\x99\xa6\xeb\x9a\x7d\xea\xa6\x2d\xb6\x03\x67\x73\xb0\xd4\x9c\x29\x70\xbf\x82\x5f\xa6\x81\xce\x81\xb1\x98\x21\x4b\x93\xcf\xf6\x46\x66\x2e\x9c\x1c\x7c\x65\x87\x4e\x79\xdb\xc8\x98\x21\xab\x58\x46\x3a\x8a\x72\x6d\x83\x24\xba\x1c\x70\x90\x31\x97\x96\x2d\x98\x2d\xab\xc8\xe2\x37\x29\x09\x1b\x78\xcf\xf2\xfc\x6c\xa2\xe1\x12\x1c\x25\xe6\xdb\x7c\xe0\xc4\xd4\x99\x0f\x5c\x1e\x30\x31\xa7\x95\x84\x76\x27\x93\x72\xa0\x01\x14\x7f\x75\x35\x10\xae\xf8\x51\x0a\xe4\x4c\x33\xc4\xb9\xa5\xc9\xe8\x34\x18\x09\x7f\xfd\x7d\x56\xa2\x15\x5c\xed\xd1\x4a\x87\xb6\x73\x0a\x8d\x35\xd2\xbd\xdd\x92\x12\x2d\x54\xcd\x4a\x6d\x92\x3d\xec\x37\xf2\xb8\x1e\x6b\xcb\xdd\x66\xa0\x6f\x19\xcd\xc1\x11\x4a\x77\x00\x0e\x6f\xf1\xd5\x6d\xbe\x65\xfe\x1c\x54\x11\xc4\x13\xbd\x04\x06\xe1\x69\x24\xf4\x86\x09\x14\xfa\x7c\x62\xbf\xeb\xe1\xb8\x69\xb4\x85\x5b\x7e\x87\xc2\x8f\x2f\xfe\x46\x59\x0f\xce\xd0\x65\xf8\x1b\x18\xad\xe7\xe8\x32\x68\xf2\x03\x0c\xe5\x29\x9a\xc1\x4b\xf0\xfd\x07\xe8\x2f\x0d\x64\x5d\x82\xef\xde\xfe\x59\x63\x20\xb8\xfd\x15\x60\x0e\xf1\x7d\x89\x61\x8c\x3f\x0c\x10\x37\xfa\xb7\xb7\x42\x6f\x94\x83\xd9\x07\x00\xfd\x5e\x1c\x01\xe8\x0c\xc1\x49\xb8\x33\x16\xfe\x66\x7b\x48\x4e\x92\x94\x43\xf1\x03\x9a\x1b\x0d\x15\xca\x13\xd3\x65\xaf\x3f\x4a\xe8\x13\x3c\x76\x46\xed\x0d\x5b\xd1\x2d\xb2\x18\xf9\x2d\x96\x04\x23\x55\x84\xdf\x41\xe2\x29\xe0\xae\x7b\x31\x9f\x0c\xef\xbb\x60\x6e\x99\x32\x52\x16\x16\xd4\x81\x0e\x8d\xc9\x02\x4e\x90\xa7\x86\x92\x5b\x7a\x51\x76\x8b\x0d\x2d\x60\x3f\xb4\xd5\x2d\xff\x61\xdf\xa6\xe9\x72\x63\xd9\x85\xf8\xc1\x40\x18\x8d\x07\xbd\x61\xe4\xb7\x2f\x00\x00\xd0\xe5\x7b\x57\x63\xfe\x4a\x00\x9e\xf4\xb7\xb7\x63\xdf\xd9\x0d\x47\x83\x4e\x63\xe4\x41\xf0\x43\xf0\x87\xf8\x07\x18\x0a\x5d\xa1\x31\x02\x7f\xe0\xee\xb7\x64\x6f\x14\x0e\xc4\xc3\xa4\x2b\x42\x7f\x34\xe1\x88\x34\xe1\xca\x78\xaa\xc3\xe4\x2b\x41\x61\x23\xe2\xe6\xa7\xbd\x24\x3c\xfd\x02\x40\x83\x1f\x0a\xe0\xb1\x2d\xf4\xc0\x1f\xf8\x5f\xf8\xdf\x17\x7f\xe0\x7f\x11\x7f\xff\xe7\x0f\xc2\xfb\x4c\xfc\x45\xfc\x0d\x46\xfe\x43\x20\x74\x87\x82\xab\x14\xa1\xd7\x3c\x4b\xd5\x4c\x89\x79\xe0\x40\xcd\x14\x53\xf8\x6c\xcd\xfc\xef\x3e\x9a\xd9\x9d\x53\x03\x3d\x6c\xe6\xe1\x72\x8a\xd8\x4e\xdb\x3b\x18\x3d\x8e\x01\x18\xba\xba\x02\x3f\xb7\x1e\xe0\xdc\xff\x79\xf4\x7c\x27\x80\x9f\xd1\x11\x71\x96\x36\x6a\x8f\xca\x63\x12\x61\x82\xc5\x70\x18\x97\xe7\x30\x35\x04\x3a\x94\xcb\x34\xa4\x09\x4e\x63\x03\x32\xce\xee\xd6\xca\x76\xb9\x4d\x0b\xf3\x0e\xe6\x36\x05\x69\x92\xdb\xe8\x20\xc9\xe5\xd6\x9d\xb9\x14\xa4\xc2\x85\xee\x88\x0e\x94\x74\x64\xcf\xa1\x8c\xc0\x4f\x70\x72\xf2\x23\xfe\xd4\xcd\xe2\x44\x53\x53\x22\xd5\x2e\x31\x59\x37\xc1\x6f\x20\x9f\x37\xba\xca\xc9\xe6\x0f\xc4\xcd\x8a\x91\x2f\xcb\x76\x9d\x1b\xc8\x53\x68\x41\xd9\x41\x16\xf8\x80\xd6\x5a\x33\x26\xa7\x34\x73\xe6\x45\x0a\xbd\x71\xb7\xeb\xcb\x27\x41\x1d\x1a\x32\x02\x92\x36\xd1\x0c\x27\xf9\xd0\xdf\x57\xd7\x35\x28\x69\xba\xe6\x68\xc8\x4e\x87\x0b\xcb\x03\x4a\x00\xfa\xbb\xcc\xa2\xb1\x98\x49\xc8\x4a\x07\x32\x16\x33\xd1\x5e\x48\xc8\x70\x2c\x17\x91\x66\x38\x68\x82\xac\x04\x50\xea\x0e\x42\x29\x89\x55\x1d\x4e\xb2\xb0\x46\xf6\x16\x52\x70\x91\x44\x12\xd7\x0c\xda\x0e\xb2\xc4\x25\xd2\x26\x53\x07\xd8\x33\xe8\xea\x21\x29\x8f\x33\xb5\x90\x3d\x35\x75\x45\xd4\xcd\x65\x31\xd0\x0c\x29\xda\x62\x56\x0c\x37\xd5\x26\xd3\x2c\xa8\xb4\x62\x8a\x1d\x91\x77\xc7\x5d\x3c\x67\x3b\xd4\x20\xfd\xe5\x46\xdf\x2a\x83\xe5\x9b\x37\xb4\x4e\xd1\x2b\x4e\x63\x49\xc5\x56\xb4\x62\x03\xce\x50\x0a\x20\x43\x25\x01\xbd\x15\xb6\x14\x48\x6e\x87\x83\x43\x55\x18\x26\xc9\x07\x6b\x31\x5c\x6c\x2e\x31\xbc\x77\xe5\xf5\x1b\x03\x07\xad\x92\x26\x12\xd8\x6c\xfa\x38\xb0\xe7\xa6\x61\x9b\x56\xba\xee\x3d\xa1\x03\x5e\xfd\x45\xb8\x9d\xd5\x6e\x69\x2d\x86\x28\xfa\xbd\x5d\x51\xc6\xc3\x4e\xef\x0a\xd4\x47\x03\x41\x38\x0d\xe0\x76\x15\x19\x59\x96\xd8\x5b\x87\x91\xad\x00\x5f\x7d\x9a\x92\xee\x73\xe0\xcc\xe5\x70\x57\xde\x14\xd7\xb4\xf1\xb7\xe9\xaa\xf3\xdd\x4b\xd6\xe8\x35\x67\x7a\x8a\x52\x09\x9a\x3e\xcb\xb1\xa9\xe4\x72\xce\xbe\xea\x48\xee\xbd\x04\x16\xb5\xd9\x32\xca\x90\x68\xbb\xbd\x94\x36\x76\x77\x7c\x62\x74\xdf\xa9\xd4\xe0\x0d\x74\x9f\x62\xa3\xb9\xea\xde\xd5\x53\x72\x8d\x6c\x5f\x3d\x25\x77\xc1\x36\xa6\x93\xc2\x22\x9c\xcf\x75\xcd\x2b\xf6\x01\x59\xcb\xc0\xbb\x8c\x66\xad\x00\x86\xeb\x19\xc1\xd2\x61\x39\x9e\x37\x0b\x8d\x19\x58\x83\x30\x86\x1f\x8c\xfc\x15\x01\xdc\xfb\xa1\xd3\x6b\x0c\x04\x2f\x7d\xaf\x3f\x07\x3f\xf5\xfa\xe0\xb6\xd3\x7b\xe0\xbb\x63\x61\xf3\x9d\x7f\xda\x7e\x6f\xf0\x8d\xb6\x00\xf0\x22\x61\xf6\x56\x7b\x12\xd1\xce\x90\x0d\x36\x65\x80\x81\x56\xce\x07\xd4\x4f\x4f\x32\x24\x3e\xb9\xbc\xb4\xd0\x44\xd6\xa1\x6d\xef\xd8\x9a\x5f\xe4\x94\xee\x3b\xc3\x8e\xda\x70\x22\xeb\x50\x9b\xb9\xd1\x9d\x18\x84\x49\x36\x38\x9d\x41\x63\x01\x75\x7d\xed\xa2\x42\xca\x59\x66\x2f\xec\xb6\xfd\xbc\xfe\x48\x55\x63\x1a\xf3\x19\x3e\x30\x5b\xb3\x99\x52\x44\x75\xec\xab\x76\x07\x54\x4c\x8e\x98\xe8\xc4\x31\xee\x75\xee\xc7\xe1\xfc\xf1\x35\x5e\x95\x96\x42\xd4\xab\x6c\xfb\xea\x4e\x26\x39\xe2\xf9\xd3\x8a\xe4\x58\x08\x81\x53\x4d\x39\xfb\xb1\x3f\xb1\x34\x61\x2a\x91\x4f\x43\x70\x96\xd5\x55\xdb\x2d\x93\xcc\x4e\xdb\x05\xcd\x9a\xca\x32\x39\x4c\x69\x51\xb6\x47\xf2\x18\xf4\xfb\xc6\x8e\x69\x27\x57\xa0\x98\x9e\x52\xe5\x3a\xcf\x15\x62\xdb\xaf\x7b\xf1\x1a\xa5\x74\x44\xa6\x33\x3b\x37\xba\x53\x5a\xd8\xbd\xf1\x3a\xe0\xdf\xd7\xc1\xf9\x4c\xa6\x75\x71\x81\x58\xa9\xfa\x4a\x48\x77\x50\x37\x17\x73\x1c\xa7\x76\x64\xe6\xbd\xa9\xa2\xd3\x1b\x0a\x83\x11\xe8\xf4\x46\xfd\x3c\xc7\xe0\xb9\xec\x21\x38\xc5\xcf\xc1\x09\x16\xfc\xe1\x35\x96\x25\x18\x55\x52\x11\x49\x72\x08\x57\x69\x99\x26\x29\xbc\x26\x33\x2a\x52\x54\x44\xc8\x18\x8d\x58\x09\xc9\x38\x45\x62\x24\x4e\x91\x48\xa6\x18\x89\x64\x39\x16\x97\x30\x4e\x26\x55\xee\xe4\xec\xc7\x97\x60\xc1\x6d\xbb\x56\xfe\xa7\x8d\xca\xba\xef\x73\x80\x9f\x03\xc7\x5a\xa0\xb3\x1f\xee\x8c\x37\x9a\x22\xb0\xdd\x2e\xbe\x88\xd6\x15\x00\x68\x21\x30\x31\xdd\x60\xd8\x31\x81\x84\xc0\xc2\xb0\x90\x0e\x1d\xa4\xb8\xdf\x37\x14\xc2\x95\x04\xfb\x1c\x48\x0b\x07\x68\x0e\x50\x4c\x64\x1b\x27\x0e\x98\x41\xc7\x9d\x68\x55\xd3\xcd\x43\xdc\x5c\x7d\x92\xaa\xb8\xdc\xe1\xb7\x51\x21\xc1\xb2\x14\x87\xd1\x1c\x4b\x9f\x03\xfc\xec\xc7\xfe\x98\x58\x9a\xe5\x38\x92\x65\x58\x2e\x1b\x51\x81\x99\xec\x32\x45\x1d\x8c\x6b\xc3\x16\xeb\xa3\x4a\x0f\xb5\xfc\x6d\xe9\x83\x03\x2d\xbf\x00\x66\x13\x15\xe4\x85\xff\x5e\x7e\x50\x26\xe3\xfc\xbc\x6c\x21\x27\x8e\x8e\xed\xec\x1f\x29\x8a\x8e\xe2\xfc\x6d\x31\x74\x9e\x20\xa0\xff\xd8\x13\x9a\xa0\xfe\x5c\x20\x91\x5f\xd0\x94\x2f\xd0\x06\x57\xe2\xf1\x9f\x9a\x92\xc5\x5b\x58\x6e\x71\xa8\xd5\x05\x78\x12\x13\x5f\x64\x5d\x23\x77\xd2\x2b\x8e\x7f\xbe\x7a\x05\xdc\x5f\x33\xac\x39\x27\xcf\x55\x90\x03\x35\xdd\x06\xaf\xb6\x69\x48\xd9\xc6\x16\xd6\xa8\x1c\xaa\x87\x00\x4f\xa0\x87\x70\x65\x34\x83\xb7\xc8\xa1\x98\x52\xa3\x30\xed\x3c\x4e\x7a\xc3\x40\x2d\x51\xef\xe4\xa5\xe3\x21\x1f\x61\x6a\x80\x25\x28\x44\x9c\x6c\x29\xf8\xcd\xa1\x18\x90\x53\xe1\x94\x6c\x63\x21\x77\x9e\x29\x68\xe4\xc3\x2e\xe6\x4a\x69\xd8\x8d\xe9\x04\x5f\x13\xe7\x85\x76\x64\xc1\x77\x96\x71\x1c\xa8\x8b\xb2\xa9\x19\x19\xeb\xdc\x2a\x42\xe2\xdc\x34\xf5\x8c\x65\x75\x68\x23\x51\x45\x59\x7d\xed\x3d\xb6\x90\x8d\xac\x8f\x2c\x90\x19\x5c\x89\xce\x4a\xf4\x96\x72\xb4\x5f\x59\x50\x73\xcb\x74\x4c\xd9\xd4\x33\xe5\x4a\xf6\x51\x68\x2c\x08\x2a\xc1\xa2\x61\xb0\x1c\xb8\x90\x65\x64\xdb\xea\x42\x17\x33\x0d\x25\x10\x1c\x6a\x3a\x52\x8a\xa0\x02\xd6\x33\x4c\x28\x7b\xe8\x65\x94\x96\x1d\x3a\x12\x33\x4a\x4c\x0b\xe6\xc5\xea\x19\x59\xb6\x8f\xab\x2a\xf2\x71\xa7\xba\x5c\x1a\xbf\x6b\xea\xab\x24\xe8\x81\x53\x61\x2e\xad\xdd\xa9\x31\x1d\x3c\x67\xaa\x8c\x14\x5e\x1e\xcd\x36\x8b\x56\xb0\xcb\x64\x8e\xde\x62\xa5\xec\x8b\xe2\xcd\x92\x07\x4e\x92\x81\x77\x30\x17\x96\xbc\x39\x92\x96\x31\x3d\x85\x2e\xe7\xe4\xe4\xf2\x32\x7b\x95\x3d\x7b\x1c\x04\x15\xc3\x87\xaa\x33\x38\xa1\x5e\x75\x4d\x25\x3f\xa6\x08\xdc\xe6\x3e\x33\x9c\x57\x19\x9e\x49\x36\x71\x3e\x3e\x0f\x28\x38\xb2\x9f\x07\xe2\x2f\xb3\xa7\x02\xec\xde\x34\x50\x00\x97\x4b\x6e\x03\x95\x43\xd1\x63\x49\xb3\x83\x43\xe2\x40\x32\x4d\x1d\x41\x23\x9c\xb7\x34\x19\x89\x46\x6c\x8e\xf6\x7f\x8b\xcf\xdb\xdb\x93\x93\x62\x62\x46\x8f\x9d\xdd\x4c\x3e\xb4\xcc\x85\xa1\x78\xd7\x54\xe8\xda\x7c\x0e\x27\x68\x17\xa9\x66\x8b\x68\x05\x65\x27\xce\x57\xe4\xd0\x44\xea\x45\x06\x9e\xb8\xa2\x77\xd5\x05\x68\xb4\x85\xc6\x0d\x38\x3d\x8d\xaa\xfe\x3f\x3f\x01\x76\x76\x56\x84\x2b\xad\x7d\xa8\xee\xff\xdd\xe9\x81\x12\xf8\x62\xbd\x91\x40\x9f\xe8\x2a\x9f\xc3\x2f\x59\x79\xe7\x51\x07\xa1\x5f\x66\xef\x0d\xc5\xed\x78\x09\x6c\xc5\x30\x1d\x60\x2c\x74\xdd\x95\x2d\xd5\xbe\xa3\x00\x59\x46\xb9\x03\xb3\x19\xbe\x3b\xe8\x3f\x4c\x7d\x31\x43\x61\x91\x47\x2a\xf6\x1c\x10\xf8\x31\x49\xfd\x7d\xaa\x4d\xa6\xa2\x91\xfd\x48\x49\x7d\xa4\x9b\xcb\x8c\x46\xee\x93\xf4\x36\xc9\x23\x12\x69\x2a\xf0\x60\xd2\x11\x7b\x8f\xd2\x31\x7b\x4e\xad\x08\xb5\x0f\x94\x8e\xdb\x7f\x96\x86\xfc\x0b\x00\x77\x83\xce\x2d\x3f\x78\x06\x37\xc2\x73\xdc\xd2\xcf\x77\x7a\xf5\x7c\x6b\x25\xb1\x1d\xe8\xfe\x00\x0c\x84\xbb\x2e\xdf\x88\x14\xbb\x45\x4e\x53\xe4\x26\x03\xc0\xb1\x16\x5b\xae\x37\xd1\xfe\xd9\x17\xb0\xa9\x85\x0b\xa4\xe5\x87\xe0\x8f\x3f\xbe\x00\x50\x17\xae\x3a\x3d\x6f\xc0\xf9\x00\x40\xd1\x3e\x4e\x65\x68\x3b\xa7\xa7\x68\xe5\xb8\xb3\xda\x29\x9a\x9b\xf2\xd4\xbf\xa9\xc7\x39\x03\xff\x03\x70\xd7\xca\xcf\x00\x0c\x53\x85\x33\x9f\xec\xd9\xff\xb8\xff\xfe\xf8\x02\x80\xd0\x6b\xfe\xf8\xf2\xc7\x1f\xdb\x42\xbb\x4d\x0d\x6d\x58\x6c\xb7\xaf\xb4\xc7\x15\x35\x42\xe7\xf2\x72\x43\x28\x90\xa6\xaa\x20\xfe\x9a\x6e\xfa\x61\x9d\xc4\x4a\xad\x82\xec\x2f\x20\xbe\x26\xbb\x65\x25\x39\xf7\x9e\x83\x13\xcf\xaf\x9c\x5c\x5e\x86\x87\x65\x76\xca\x15\x32\x4f\x16\xed\x12\x0e\x9c\x54\x8c\x78\xb2\x55\x5e\xcc\x92\x7e\x46\xea\x08\x0e\x34\xfd\xbc\x5d\xc9\x94\xa5\xca\x2e\xc3\x3e\x49\x4b\xd1\x09\xb3\xe3\xa4\x2d\x05\x54\x7e\x57\xe2\x52\x51\xd8\x03\x53\x97\x02\x6a\xbb\xc9\x4b\x56\x83\x9c\xf4\x25\x76\xaa\x70\x5f\x5b\xcd\x39\xa9\x18\x98\x69\x94\xb3\xd2\x0b\x5b\xc1\xb8\x2b\x58\x2e\x2b\x9b\xe8\xe4\xe7\x2c\xe9\x25\x69\x1b\xd2\xa9\xc3\x66\x06\x57\x39\x4b\x3b\x59\x8b\x66\xff\x95\x65\x2f\x67\x25\x22\xe3\x03\xe9\xe6\x1c\xa5\x55\xb6\x38\x2b\xd1\x42\xf6\x42\x4f\xad\xcc\x71\x56\xe2\x0c\x39\x30\xe3\x91\x8a\x50\xe6\x63\x5b\x9b\x18\xd0\x59\x58\x28\xad\x08\x83\x63\xce\xfe\xfa\x7b\x9b\x2b\xfe\xf3\x7f\x69\xd9\xe2\x5f\x7f\x27\x75\x8e\x66\x66\xc6\x06\xc5\x16\x97\x61\x1a\x28\x37\xf7\xdc\xe2\xda\x45\x13\x48\xa6\xcd\x90\x28\xb9\xd9\x83\x57\x8d\xc4\x5a\xd0\x98\xa0\x98\x59\xa6\x3f\x9c\x69\x86\x98\x61\x3d\xd9\x00\x62\x32\x31\x49\x05\x0a\xe8\x4e\xe0\x3c\x06\xeb\xc5\x22\x9b\x72\x3b\xb7\x17\xfe\xfa\x3b\xb9\x94\x17\xcf\x6d\xdc\x2e\x73\xc5\x9e\xa0\xc4\xda\xa8\x61\xb8\xd3\x5c\xa9\xa1\xba\xc5\x94\x3b\xae\xa2\x88\x8b\xad\x21\xa8\x04\x43\x4b\x31\x1c\x5a\x3e\x7b\x3b\x49\x4a\xf2\x00\xf5\xbe\x8e\x2b\x79\x97\x86\xef\xac\xd2\x2b\x57\x63\x85\x7b\xf9\x15\xa6\x05\x35\x7e\xc1\x11\xf1\x7d\x99\x0e\x2e\x14\x09\xf7\x12\xdc\x9c\xba\x6c\xed\x6c\xfe\x12\x44\xec\xe6\xb7\xb4\xf1\x1c\xbd\x7b\x2d\xb5\x40\x2e\x67\x11\xc0\x4b\xea\x8d\xcc\xd5\x6b\x4d\x46\x59\x91\x8c\xf7\x10\x28\xe6\x42\xd2\x11\x98\x5b\x48\xd6\xbc\x05\xee\xf2\x95\xde\x7b\x96\xf7\x46\x8f\xfc\xef\xdb\x57\xd1\x6b\x65\x7e\x4b\x75\x74\xc9\x0a\xcf\x2a\x25\x9b\xd5\x36\x79\x73\x0f\x19\x6c\xd5\x21\xea\xda\x4c\xcb\x5a\x2f\x3a\xf6\x51\x84\x4f\x30\x8e\xc4\xbe\xba\xa6\x84\x26\x12\xde\x26\x51\x26\xe2\xf3\x6d\xc4\xbb\xbe\xa3\xe0\xa2\x8a\xa1\x30\xca\x29\x89\x8c\xee\xf6\x46\x8b\xf5\xaa\xad\xbf\x1f\x4f\x88\x92\xf7\x78\xe4\x0a\x95\xbb\x6e\x5f\x46\xc8\xcc\xc4\xe9\x68\x62\x96\xbe\x0a\x25\x57\xd0\x82\x28\x3f\x5d\xd4\x26\x74\xa0\x57\x65\x93\x73\xb0\x08\x34\xf9\x11\x5f\x20\x5b\x01\xbe\xdd\xc3\x21\xc7\x40\x9a\x76\x5c\xe2\x10\xbc\x19\xe5\xf2\x07\xa0\xcc\xab\xc2\x3f\x00\x6d\x5e\xd1\x7a\x19\xb4\xd1\x5a\xa3\x64\xe1\x7a\x58\x54\x74\x82\x8b\x9a\xa1\x39\x1a\xd4\x45\xff\x10\xfa\x9f\xf6\xbb\x7e\x72\x0e\x4e\x08\x0c\xe7\xbe\xe3\xd8\x77\x12\x07\x38\x75\x89\x73\x97\x14\xf7\x27\x46\xb2\x24\xf9\x0d\xc3\x4f\x12\x85\x4c\x99\xc8\x09\xd1\xaf\xcc\x8b\x19\xaa\xb4\xf6\xd6\x46\x72\x09\x51\x04\x53\xab\x42\x88\x14\x17\x36\xda\xc6\xbe\x9a\xb1\x73\x8f\x65\x3e\x39\x9a\x23\x98\x2a\xf4\x28\x11\x2a\x8a\x98\xdc\x45\xcf\xa5\x41\x53\x38\x55\x49\x26\x5a\xf4\xb3\xbd\x70\xbd\xc9\x3b\x4c\x98\x4b\x82\xc1\x59\x8c\xaa\x42\x82\x09\x49\x04\x73\x42\x09\x12\x35\x8c\xab\x64\x02\x35\x7f\xb6\x5c\x97\x97\x82\xc5\xb1\x6a\x8a\x62\xbd\xce\x80\x93\x89\x85\x26\xd0\x31\xad\xfc\xbe\x66\x69\x9c\x60\xab\xa1\x8f\x2a\x29\xb8\x18\xac\x84\x18\x1c\x5d\xab\xd4\x19\x9c\x27\x86\x5f\x61\x21\xae\x14\x2b\x17\x3b\x47\x90\x4c\x25\x8b\xc5\x31\x0f\x7d\xd0\x0b\x5e\x90\x9c\x4f\x80\x66\x6a\x78\x25\x02\x78\x94\xc0\x26\x0e\x75\xc7\x7f\x3e\x21\x8e\x60\xb9\x4a\x84\x88\x58\x4f\x04\x9b\x57\xfe\xc5\xf2\x79\x94\x70\x8c\xe6\x98\x6a\x22\x91\xbe\x38\x9b\xcd\xc2\x5c\xcb\xc2\x71\xbc\x46\x57\x32\x5c\x9c\x12\x55\x6d\x15\xde\xcc\x67\xce\x74\x51\xd5\x90\x9e\xeb\x19\x71\x9c\xac\x91\xd5\x3a\x9e\x0e\x97\x02\xc2\x0a\x9c\x55\x81\x18\x34\x5d\xab\x34\x40\x70\x46\xd4\x8c\x09\xb2\x1d\x71\xb7\xc6\xa7\x80\x14\xc3\x55\x1b\x8b\x78\x2d\x16\x00\x79\xc5\x54\x30\x7f\x2e\xc1\x71\x96\x66\x88\x4a\x44\xd8\x8d\xf9\xaa\xa6\x15\xc6\x1f\xb9\x34\x08\x92\x25\xe9\x4a\x34\x38\xdf\xa8\xf2\xd1\x92\x24\x8e\x55\xb2\x28\x02\x4b\x61\xbd\x78\x10\xe2\x24\x4d\x71\x95\x06\x21\x81\x87\x23\xdd\x42\x33\xf3\x03\x89\xbf\x90\x65\x6e\x36\x92\x4d\xc3\x76\x2c\xa8\x15\x4c\xbb\x38\xc9\x62\x64\xa5\x01\x49\x10\x62\x24\x45\xce\xc5\x4d\x51\x35\xac\x92\x69\x11\xa4\x98\x88\xe3\x72\xf1\xd3\x04\x51\xc9\xa8\x08\xaa\x54\x28\x82\x33\x18\x4b\x55\x9a\x36\x08\xda\xe5\x3b\x18\x80\x16\x32\xe0\x0c\x89\xb2\xa9\x2f\x66\x05\x63\x8f\x21\x6b\x78\xb5\x18\x8b\x0c\xfb\x7a\x61\x2c\x6c\x94\x18\x74\xf8\x77\x12\x03\x38\x16\xc5\x5e\x49\xfd\x24\xe5\x8d\x66\x69\x31\x9b\xe7\xf8\x0f\x9f\x0a\xbe\x3f\x15\x5a\x54\x2c\x73\x1e\x0d\x48\xc5\xa4\xfb\xf0\x69\x44\xf5\x54\xcd\x47\x91\x35\x7f\x22\x4c\xad\x64\x14\x1d\x33\x2c\xef\x4d\xa3\x4a\xec\x4d\x95\xf2\xa7\xdf\xe0\xcc\xb4\x4b\xc6\x7b\x9b\x4b\x70\x05\x45\x1a\x2d\x72\x6f\x2d\x52\xb4\x47\x2b\xe5\x08\x49\x10\x75\x17\x29\xb4\x22\x39\xc6\x23\x37\x5b\xac\x90\x92\x31\x88\x88\x43\x49\xd4\xc4\xb9\x85\x64\x73\x36\x5f\x84\x01\xf7\x26\xa0\xdc\xb5\xc2\x14\x6a\x95\x9c\x27\xc5\x8a\x16\x92\x16\x9a\xae\xe4\x92\x22\x70\x97\x14\x46\x00\x0c\xbf\x24\xc9\x4b\x92\xfc\x93\x22\x58\xca\x25\x85\x95\x27\xe5\x47\x95\x92\xa5\x19\x41\x2e\x56\x91\x22\x49\xb8\x51\x6c\x79\x82\x34\x26\xea\xda\xfb\x42\x53\x34\x67\xed\x15\x3a\xe7\xa3\xaf\xe1\xac\x9b\x4f\x54\xc0\x8f\x87\x5e\x68\xea\x04\x8e\xc8\x17\x0c\x15\x10\xe2\xb0\x90\x4e\x56\xbe\x9d\x7b\x5c\xb9\x6a\xc2\xbd\x73\x64\x39\x7a\xd4\xeb\xaa\xf1\x74\x73\xc5\x0c\x7a\x54\xbf\xd7\x11\xee\x1a\xb7\xbd\x56\xbd\x46\x12\x3c\x45\x32\x2f\xf4\x5d\xaf\x39\x1c\x74\xaf\x1e\x6f\x6a\x57\xf5\x6e\xe3\xf6\xbe\xdb\x69\xf5\xa9\x61\x4d\x78\x7e\x7c\x18\x27\xb5\x94\x49\x84\x70\x89\xd4\x9f\xae\xee\xaf\x1f\x1f\xba\x8f\xfd\xe7\x76\xab\xfb\x30\xba\x79\x7c\xa0\x5b\x57\x6d\x9e\xec\xf6\x9e\x9f\x89\xeb\xfb\x9b\xdb\x5a\x9f\xbf\xe6\xc7\xc2\x7d\x6b\xcc\x74\xef\x1a\x43\xa1\xf5\xf0\xd4\xef\x95\x26\x42\x7a\x44\x06\x77\xcf\xed\x4e\x97\x68\x74\xc8\x56\xef\x9e\xaa\x3f\x75\x5b\xb7\xbd\x66\xb7\x75\x3d\xee\xdd\x8d\x89\xf6\x33\xf9\x72\xdb\x1a\xb6\xfb\xbd\x71\x43\xe8\xf3\xc3\xc7\xda\x7d\xa3\xd6\x7f\x22\xda\xa5\x89\x50\x2e\x11\x9e\x7e\xac\xdf\x3d\xf3\xf4\x33\xf5\xc8\x0b\xed\xa7\xc7\x01\x31\xbe\xe9\x13\xe3\x3e\x55\x1f\x5f\xb5\xc7\xf7\x35\x4a\x18\xdf\xdd\xf4\x7b\xc4\x7d\xfb\x81\x7a\x1c\xb4\xfb\x9d\x41\xef\xe6\xa6\x4d\x9c\xec\x7b\xbc\x1e\x0c\x85\xa2\x65\xbe\xe2\x13\x76\xc9\xa3\xe7\xe7\x80\xda\x9c\xab\x2b\xb2\xc0\xdd\x53\x5c\x55\xd6\x91\xaa\x9c\x1c\x3a\x8a\xa4\xb1\x15\x65\xef\xfc\xa0\x77\x9f\x51\xb1\xa0\x69\x27\x87\xf6\x1d\x69\xe1\xe9\xa1\xc8\x18\x88\x9f\x09\x3c\x07\xee\xb0\xf8\xe7\xab\x1f\xa5\x7e\xbd\x04\x5f\xe9\x3f\x83\x33\x97\x5f\xcf\xc1\xd7\xed\x5e\x88\xfb\xc8\x80\x8e\xf6\x81\xbe\xfe\x5f\x96\xa1\x26\xa9\xe1\x09\x6a\xc4\x39\x20\x3f\x95\x5a\xec\x94\xe2\x39\xc0\x3c\x62\xb6\xe3\x06\x36\xc6\x24\x9c\x91\x5d\xdc\x38\x86\x6d\x08\x97\x26\x40\xc6\x09\xa4\x48\x13\x45\x7b\x6c\x79\xc8\x73\x80\xfb\x02\xf9\x77\xd1\x7c\xbd\x74\x45\xfc\xea\x9b\x82\xf8\x86\xd6\x2e\x8d\x7d\x9d\x68\x79\xae\xa8\x80\x2b\x8a\xa8\x05\x06\xf4\x49\x5a\x0e\x08\x7c\xb6\x96\x13\xf2\x94\xd3\xf2\x9e\xbe\xb7\x3c\x57\x44\xc8\x15\xc3\xb2\xf8\xa7\x6a\xd9\x27\xf0\xd9\x5a\x4e\xc8\x53\x4e\xcb\x7b\xce\xd5\x3e\x57\x05\x4e\x36\xed\x58\xe2\xbe\x4e\x36\x3c\x9a\x18\x8d\x01\x68\x1a\x72\xb8\x44\x33\x0c\x2b\x53\x08\x72\xb4\x24\x73\x2a\xa6\x62\x14\x05\x25\x95\x90\x49\x4c\x26\x59\x06\x2a\x0a\x5b\xab\x91\x18\x92\x10\xcd\x50\x92\x42\xd3\x0a\xc6\x41\x46\x51\x6b\xb8\xea\xc6\x6c\x9c\x54\x93\x59\x49\x85\x38\xe4\x64\x9a\xc4\x71\x89\x25\x18\x0c\xab\xa9\x1c\xa6\x4a\x35\x9a\x81\x32\x46\x91\x48\xc1\x29\x82\x80\xa4\x4c\x70\x04\xc6\xb2\x32\x41\xe2\x90\x21\x30\x06\x31\x0c\xe6\xcf\x3a\x78\x22\xd9\xf5\x53\x1c\x26\x99\x03\x87\x99\x0f\xc9\x51\x2c\x43\x15\x3e\x0d\xfc\x3a\xce\x7a\x27\xaf\x99\x73\xaf\x6e\x37\xf1\x77\x0e\x28\xf7\x1f\x3c\xf8\x27\xfc\x11\xdf\x7c\x70\xa7\x1e\x9e\xe7\xf9\xe6\xb5\xc3\x6a\x17\x26\x34\x5a\xb7\x83\x45\xe3\x99\x57\xe9\x66\x4d\x79\xb4\xf8\xfb\x6f\xd8\xb8\xf3\x7e\xd7\x78\x9b\x68\xb7\x9d\xd5\x5c\xab\x2f\x5e\x26\xc3\x3b\x1c\xde\x9a\x77\xcf\x73\xf2\xbd\x31\x6c\xa8\x2f\x78\xfd\xf5\xf1\x71\x65\xac\x6d\x47\xb5\xd6\xd6\xbd\xd1\xa3\x55\xc4\x3e\xbf\xbc\xe0\x2b\xd9\x45\xcd\x3f\x49\x96\x2a\x4f\xdc\x4f\x9d\xcd\x3f\xfc\xbd\xfb\xcf\x72\xfb\x7d\xc9\xdf\xdd\xbf\x79\x9f\xf8\xd6\xed\xcd\xf5\x07\x64\xee\x67\x7d\xbd\xd9\x75\xd0\xeb\xb3\x34\x9d\x3f\x77\x6a\xc3\xf1\x4d\x5f\x45\xd7\x52\x47\x79\x7b\x7f\xe5\x96\x7d\x9c\x77\xac\x0b\x95\xbd\x15\x24\xb3\xa3\xc9\x4b\xaa\x51\xe7\xd7\x38\xe3\xcc\x9c\xc7\xab\x96\xd4\x6e\x2f\xe0\x52\xa8\x4d\x9f\xd8\x8e\x40\xb6\x7e\x3d\x69\x1e\xfd\xdb\x1e\xd5\x85\xbf\xe6\xc4\x3d\xbf\xfd\xbb\x8a\x7e\xd9\xfc\xbd\xf0\x4f\x38\x75\xcf\xf3\x4d\xec\x3a\xed\xf1\xbf\xfa\xef\x24\xf4\x56\xbd\x71\xb7\x9b\xe1\x1d\x92\x03\x86\x38\x8e\xb1\x9f\x30\xa4\xc2\xb1\x2a\x4d\x32\x08\x31\xac\x82\x4b\x44\x4d\xa2\x25\x96\x53\x09\x12\xaa\x1e\xce\x1a\xcd\x70\x90\xa0\x54\xa8\xe2\x14\x46\x42\x05\x93\x68\x42\x62\x48\x52\xc2\x6a\x12\xe2\xb8\x13\xcf\x33\x91\xa9\xb6\x4f\x67\x0d\x09\x0a\xe3\x18\x8c\x2c\x7c\xea\x4f\xe5\x14\xcd\x11\x39\xe3\x85\xcc\x18\x2f\xbe\xfb\xf7\xf4\x7b\x75\xf7\xf2\x8a\xf7\x16\xb4\x89\x49\xd7\xb5\x47\xca\x58\xf7\x3f\xc6\xab\x2b\xf2\x61\x6e\xbe\x7d\xfb\x68\xf1\x7d\xa7\x81\xdf\x10\xb7\xb5\x7a\x8d\x79\xd1\x67\x82\xd2\x9f\x3f\x34\x6e\xe9\x76\xd7\xe2\x5a\xbd\x57\x9a\x7e\x87\xcc\x92\x68\xdf\xdc\x3a\xef\xa3\xbb\x56\xf7\xe3\x8a\x5d\xdf\x8d\x2f\x20\x6f\x7a\xa8\xbd\xa1\x12\x31\xc8\xc1\x98\x7f\x58\x5d\xcf\x70\xbd\x79\xbb\x5c\xbe\x2f\x5e\x6f\xe4\xf5\xfd\x2f\x9b\xab\xb5\x2e\x78\x61\xa4\x35\x26\xf7\x77\xd6\x92\x21\x97\xef\xf0\xee\xaa\xef\xbc\x62\x0f\xef\xe8\xb5\x31\xb8\x32\x58\x9e\xba\x59\x5e\x1b\x5a\xcd\x78\x47\x70\x71\x81\x09\xd3\xe9\xc5\xd5\x1b\xbb\x16\x9a\xb3\x9a\xd1\xf6\x87\x62\xca\x50\x10\xec\x34\x73\x0a\x87\x02\xcf\xd7\xdf\x3e\xd5\x6e\x3f\xe1\xcf\x37\xa7\x6a\x43\x01\x3f\x8e\x19\x7b\xc5\x39\x20\xb0\x1b\x9c\xab\x61\xdf\x31\xfc\x3b\x86\x03\x0c\xbb\xf4\xfe\xcb\x34\x57\x02\x67\x08\xa2\xf0\x29\x45\x70\x14\xc7\xd4\x08\x8e\xc9\x31\xe6\x42\x53\xfe\x57\xfe\xd5\x9f\x6e\x34\x6a\x7d\xb1\x1e\xde\xd4\x6b\x4d\xa3\xc9\xb5\x09\x6c\xf5\x5a\xff\x66\x63\x13\xc7\x5e\x76\x96\xbf\xf0\x27\x65\xf8\xf8\x0c\xeb\xd7\xb0\xe5\x99\xb2\x90\x62\xca\xe9\x7f\xff\x9f\x9b\x32\x16\x35\xe5\x82\xe8\xaa\xc4\xc9\xf3\x7d\x83\xad\x8c\xc2\xa8\xac\x94\xb3\xf8\xd2\x9b\x54\x34\xc9\x3c\x99\xd8\x0f\x4d\x22\x63\x24\xf7\xc3\x42\x25\x12\xdb\xfd\xb0\xd0\x89\x44\x67\x3f\x2c\x4c\x1c\x0b\xb5\x1f\x96\x5a\x22\x1d\xd8\x0f\x0b\x9b\xc8\x61\x8e\x73\x2b\xc0\x51\x56\x7f\xf2\x4b\xef\xce\x01\x5b\x76\xd5\x2b\xe3\x6c\xfc\xc1\xa3\x27\xeb\x8e\xa8\xd8\xdd\x4c\x7e\xf2\xf0\xcf\x57\xc7\x3c\x28\x1f\x3b\x07\x5f\x55\xcb\x9c\x1d\xb4\x3e\xe1\x66\xa0\x95\x16\x8d\x3e\x61\x45\x39\x45\x79\xd1\x71\x19\xbb\x8b\x2a\x4c\xd8\xd5\x85\xa1\x20\xcb\x57\xdf\x7e\xab\xc2\x9e\x8c\xfe\xb2\xe9\xa1\x1a\x2c\x5e\x3d\xf8\x84\xd5\xeb\x2c\xad\x05\x1e\x64\xf3\x99\xfa\x54\xad\xed\xbb\x62\xf3\xaf\xd3\x9a\xef\xeb\x36\x9f\xb1\x4f\xd5\xda\x01\x23\xfe\xd3\xb5\x56\xe0\x38\x53\x0e\xdf\x1f\x50\x76\x5a\xe9\x8c\xea\xbe\xce\x39\xb3\x18\x3a\x35\xb8\x29\x79\x79\x5e\x71\x78\x43\x65\x87\x37\x85\x88\xc8\xb8\xdb\xcb\x9a\xc8\x0b\xf1\x50\x09\xf7\xb9\x2f\x9e\x84\x43\xd9\x9b\x1f\x26\x8e\x27\x2b\xcc\x29\xc4\x53\x8b\x0f\xd5\xbd\xf9\x61\xe3\x78\xb2\x43\x9d\xaa\xc7\x6b\x8f\x11\xec\x14\x95\xdf\x57\x08\x77\x32\xcf\xd2\x1e\x61\x4c\x45\x36\xcc\x65\x24\x49\x6c\x8d\x86\x18\xa6\xaa\x0c\xc2\x49\x96\x84\x48\xc5\x54\x85\xa0\x71\x58\x63\x54\x82\x90\x71\x95\x83\x12\x01\x09\x45\x55\x65\x09\xab\xd5\x58\x9a\xae\x91\x0c\x54\x10\xc1\xd0\x1c\xf4\x33\xfb\x83\x76\xad\x23\x2b\x42\x64\x98\x28\x67\x2e\xba\xd2\x18\x9e\xb3\x60\x1b\x3c\x8d\x8d\x68\x3f\xc3\xbe\x61\x5e\x91\x46\xbe\xce\xcc\x0e\x3b\xba\xd2\x9b\x17\x68\x22\x93\xb5\xbb\x27\xa7\x7d\x73\xf3\xeb\xf1\x81\x5d\x3e\x68\x2f\x75\xd8\x58\xd0\x5d\xfa\x96\xf7\x32\x54\x3e\x5c\x12\xad\x27\x12\xc0\xc8\x77\xc1\xfb\x57\x9a\x4d\x66\xf8\x03\xa1\x4c\xe8\x07\x7c\xf6\x8e\x23\xfd\x56\xbe\xc2\x9d\xd5\xeb\xf0\xf9\xe6\x85\x5b\x0a\x13\x73\x58\x87\xe8\x91\x1d\x6b\x2d\x33\x82\xa6\xcb\xb0\x9d\xc8\x57\x58\x7b\xfb\x78\x5b\x7a\xe8\xb9\xbb\x05\x37\x7f\x5d\xbf\xc9\x83\x21\x83\xe9\xef\xfd\xee\x7b\x8f\x6d\xb5\x7f\x11\x14\x75\x7f\xc7\x4a\xf0\xb9\x87\x46\xa3\xeb\x97\x8e\x6e\x91\x43\x69\xd0\xc0\xc9\x77\xc1\xe2\x16\x77\x54\x7f\xd0\x9c\xac\x1b\xf5\x8b\x89\xbc\x98\x10\x57\x37\x56\xf3\x76\x71\x83\x0d\x47\xe4\x7d\x1f\xde\x8c\xeb\xcb\x9f\x3f\x4f\xa2\xab\x0d\xd1\xe5\xd6\xfb\x34\xd9\xf8\x2d\x7c\xe2\xb9\x0f\xe4\xa9\xa9\x11\x51\xcb\x02\x36\xa4\x87\xa7\x17\xa2\xa9\x3f\x3d\x42\xeb\x81\x19\xaf\x96\xd2\x23\x79\xd5\xbb\x9e\xcc\x0d\x92\x1f\x36\xa6\x9d\xd6\x9c\x96\x56\xc3\xce\xa3\xb7\x5a\xc0\xd7\x66\x76\xa0\x8f\x49\x4e\xba\x9d\xb9\x98\xe0\xe9\xbe\x79\x00\xfd\x6f\xba\xf4\x7e\x00\xfd\xdb\x04\xfd\xc6\xc2\x24\x4d\x87\xa2\xdf\x1b\x77\xc2\x6a\x7e\x7f\x41\x9a\xed\xde\xb7\x5f\x78\x6d\xb0\xd6\x6c\x5c\x57\x6f\x5b\xcf\xb3\xfb\xc7\x89\xb5\x18\x7e\x1b\xf1\xa1\xfc\x33\x79\x4b\x5f\x38\x50\xfe\xca\xf4\x29\x83\x7b\xdb\x93\x7e\xc4\x96\x26\x7c\x8a\x2d\xec\xa3\x8b\x63\xda\xc2\xef\xec\x0b\x5f\x17\xff\x7c\xd6\xa0\xf5\x82\x43\xef\x08\x7a\xb8\x94\x59\xe6\x5f\x77\x8a\xf1\x5c\x69\xf1\x2c\x1b\xab\x71\xad\x51\xc8\x75\xc4\x9c\xc4\x21\xb5\xa6\x48\x90\x83\xb4\x22\x91\x24\xc9\x49\x35\x56\x55\x20\xab\x92\x54\xad\x56\x93\x70\xa8\x92\xa4\x04\x29\x86\x85\x0a\x2d\x63\x8a\xca\x51\x8c\x42\x29\x27\xde\xee\x29\x7e\x48\x34\xeb\xa7\xda\x79\x53\x00\x85\x71\x35\x3c\x73\x57\x6e\xf3\x34\x1a\x43\x05\xdb\x05\x5d\xb6\x7d\xff\x71\xff\x26\xdd\x10\x6d\x9e\x7c\x7c\x78\x1d\x58\x37\xb3\xd7\x27\x0c\x53\xaf\x58\xbb\xdb\xa9\xcd\x30\x61\xb0\xbc\x7e\xbc\xe0\x9f\x48\x7e\x33\x03\x78\x7f\x39\x33\x80\xff\x67\xbd\xf7\x98\x2e\xea\xc3\xc9\xeb\xea\x16\x8e\xef\x38\xa6\xfe\x4b\xb5\x39\x84\xc9\xa6\xd5\x7b\x79\xfa\x55\x7f\xbc\x7e\x6b\x99\x37\xa1\x87\xe7\xf9\x3e\x6d\xdd\x44\xf1\x3d\x7c\x2c\x5b\x9c\xfb\x48\x68\x34\x7f\xbd\x7f\xbc\xdd\xd7\xef\xcd\x1e\x7f\xad\xa9\x77\x83\xa7\xa6\xd9\x9d\x7e\x38\x6b\x79\x44\xea\xad\xbb\xc6\x3d\x8d\x4f\xde\x14\xbb\xd5\x86\xf5\xde\xe3\x12\xa3\x87\x17\x0f\xd3\x47\xec\x69\xf2\x66\x61\x8d\xfa\x9d\x40\xf5\x60\xeb\x81\xb8\x99\xc9\x36\xf9\xb2\xec\xce\x34\x89\x1a\x0d\xac\xdb\x6e\x09\xcf\x1f\x33\xe9\x2c\xcf\xef\x6f\x14\xee\x78\x7e\xed\xa2\x8e\x75\xb1\xeb\xab\xb5\x33\x5d\xf6\x70\xfd\x19\x83\xeb\xb9\x89\x73\xbd\xf6\xea\xa3\xdb\x58\xf7\x69\xa7\x2e\xc8\x0d\x5f\x46\x72\xe2\x58\x7d\xe3\xf9\xa2\x36\xde\xb6\xbf\x4d\x65\xa2\x60\xb4\x1f\x40\xbf\x67\xad\x47\xa3\x03\xe8\xf3\xfc\x7f\xcf\xdb\xa5\x7a\xde\xfa\xfe\xba\xe8\x1b\x2f\xb9\x62\x16\xe9\xe2\xd0\xbe\x70\x6d\xe1\x9b\x9c\xc0\x57\x49\x17\xff\x4c\x58\xc6\xa2\x05\x7e\x7c\xd3\xbc\x6f\x3c\x1b\xbf\xb0\x87\x25\xd3\xa0\xa4\x9a\x6c\x08\x1c\x3d\x18\x2d\xdf\xfa\xca\xf3\x75\x5b\xaa\x0f\x88\xc9\xe8\xc1\xee\xf5\xc7\x1f\xf8\xf3\x83\xd3\xa2\xae\x6f\x38\x7e\x32\x5a\xf5\x9b\x8f\xd3\x07\x45\x9b\x1b\xdd\x1e\x21\x37\x68\x73\xf6\x4d\xc0\xe0\xaf\xc6\x6f\xf6\xbc\x38\x43\x41\x1a\x63\x28\x24\x41\x86\x52\x09\x59\x91\xa0\x22\xb1\x34\x23\xa9\x24\x45\xb1\x14\x4b\xab\x32\x43\x30\x04\x55\x83\x0a\x24\x91\x42\x72\xb2\xa2\xa8\x98\xca\x70\x18\x81\x93\xa4\xc4\xf8\x9e\x97\x38\xcc\xf3\x12\xc5\x9e\x97\x25\xb9\x1c\xcf\xeb\x3f\x8d\x66\x8b\x87\x7a\xde\x46\xa2\xcb\x77\x3c\x6f\x9f\x68\x5c\xf0\x7d\x8a\x7e\xae\x37\x49\xa7\xfd\xd0\xea\xe3\x03\x92\xc7\x6e\xd1\xdb\x1d\x7b\x3d\x60\x8c\x1e\xce\x73\xe8\x51\x53\xd6\x1d\xc7\x1f\xf0\xd9\x9e\x97\x1f\x0a\x2f\xda\x8b\x84\x5a\xcb\x86\x6d\xdd\xd4\x8d\x9b\xce\xc2\xbe\xc0\xe8\x07\xe7\xba\x59\xb7\x26\xa6\xbd\x98\x76\xef\x2f\xc6\xcc\xd3\xf8\x95\x72\x96\x8f\xeb\xa9\x5d\x1b\x3b\x43\xaa\x71\x8b\x56\xfd\x5b\xe6\xfa\x5d\x56\xdf\xaf\x6f\x70\xec\x51\xaf\xbf\xbd\x2d\x0d\x6a\xc2\xde\x75\xd4\xd7\xce\xd5\xbf\xcb\xf3\x1e\xea\xf9\x0e\x1d\xed\xb7\xcb\xee\xcc\x3a\xa2\xe7\xe5\x6b\xcf\x5d\x96\xaf\xbd\xea\x13\xe1\x0e\x61\xca\x78\x5c\x7b\x68\xcb\xcd\xfb\x15\x73\x7f\xb1\xd4\xdb\xef\x32\x39\x6e\xe2\x34\xbc\x26\x3b\x1a\xee\xe3\x3c\xb6\xe7\xfd\x2f\x79\x3e\xfe\x48\x9e\x97\xa5\xb6\xed\x3b\x95\x75\xf1\x8f\x30\xbd\x7a\x9e\x3d\x92\x53\x99\xb7\x6e\xd6\x93\x97\xb5\xd6\xb5\xee\xb8\xfe\x83\x34\xbc\x5f\x42\xea\xa6\xdb\x35\x87\xd8\x1d\xde\xd7\xf1\xce\xb7\xae\xdc\xb2\x4d\xa9\x8f\x77\xc7\x0b\xfe\xb5\x6d\x8f\x5e\xfb\x1a\x34\xda\x8c\x36\x74\x94\xd6\xfc\xfe\xe5\xfa\xf6\xfa\x5b\xe7\xae\xb9\x6e\x53\xeb\xfa\xe4\x37\xc7\xbc\x12\x81\x58\x42\x91\xa0\x24\x61\x04\x25\x11\x35\x88\xc9\x24\x4e\x61\x32\xac\xe1\x0a\x0b\x65\x4e\x92\x6b\x38\x4b\xe2\x2a\xa7\xd2\x90\x94\x14\x86\x43\x32\x24\x15\x96\x55\x25\x0c\xc9\xb4\x7c\xb2\xa9\x18\x3c\xc0\xf3\x16\x2d\x7b\x50\x18\xc7\xd1\x79\x85\x35\xfe\xd3\xe8\xba\xd8\xa1\x9e\xb7\x99\xe8\xf2\x1d\xcf\x5b\x75\xd5\x23\xdb\xf3\x36\xaf\x17\x3a\xee\x74\xaf\xba\x2d\xea\x61\xb5\x74\x30\xa5\xd9\x78\x10\x54\xc6\x91\x68\x9d\x92\xd6\xb7\xd6\xd5\xa4\x31\xff\xa6\x3f\xbc\xdc\xce\x56\xb2\x43\x53\x5a\x4f\x25\x66\x2b\xe7\x75\xc5\xdc\x2a\xf4\xcb\x35\x25\x50\x4d\x5d\xb6\x55\x8a\x11\xf8\x69\xfd\x6a\x38\xbe\xb3\x0d\x56\x7d\x6e\xfe\xbb\x3c\xef\xa1\x9e\xef\xd0\xd1\xde\xc5\xde\x98\xe6\x11\x3d\xef\xef\x5c\xed\xf9\x0c\xcf\xbb\xaf\xe7\xe3\x8f\xe4\x79\xf7\xcd\x7f\x02\xcf\xbb\x96\xe6\x8a\x34\x5c\x69\x2b\xd4\x92\xe5\xae\xd2\xbe\x5f\xea\x83\xf6\x37\xeb\xf1\xdb\x0b\xba\x62\x5f\x6f\x56\x26\xff\xae\xce\x1f\x1e\x47\xd7\xf6\x53\x17\xa1\xce\xeb\x13\x37\xb7\xa5\x67\x16\xbd\xb6\xd1\xe3\x10\xd5\xfb\x3c\xfd\xd4\x6d\x7f\xeb\x4f\xf9\xce\xfd\xe0\x4d\x6f\xd6\xae\x2f\xda\x04\x7f\x94\x98\x37\x63\x55\x3b\xef\x8e\xb5\xaa\x0b\xda\xc9\x7b\xd6\x36\xbe\x1c\xad\xe6\xe1\x51\x73\xef\x22\x26\xbf\xa2\xcc\x15\x09\xcb\xd9\x26\x4b\xb9\x40\xed\x80\xed\xb1\xac\x7b\xbe\xaa\x1f\xd0\x89\xbf\x0d\x39\xf6\x4d\x9c\xbf\xa1\x75\x88\x7e\x7b\x81\x77\xd5\xab\x87\x62\x38\xbd\xfb\xab\xf8\x66\x33\x7a\x21\xf8\x2e\xd1\xe8\xc5\xcb\xe0\x74\x7b\xfd\x58\xe6\xeb\x8c\xb7\x38\x8e\xcb\x73\x2e\xbb\xbb\x9c\x6e\x2f\x3e\x2b\x7c\xf1\xf2\xee\x4b\x89\x8f\xac\xed\x00\x6d\xae\x04\x51\xd2\x71\x49\xfc\x27\xe7\x20\x4f\xa2\xc8\xab\x7a\xa3\x77\x61\x1c\x49\x8e\x2d\xc6\x54\x11\x12\x04\xe3\xdc\xa7\x70\x9b\x7c\xb9\x70\xe2\xfb\x91\xb8\x4e\x60\x4d\xe3\x3c\x8d\x70\xc2\x8a\x36\xb7\xd7\x9d\xc7\xae\xbe\x3b\x8f\xdc\x94\x57\xf4\x72\xe1\xe4\xf7\x23\xc9\x97\xc0\x9a\x26\x5f\x1a\xe1\xc2\xde\x49\x5c\x25\x97\x38\xd3\xb7\x55\x88\xb8\xd5\x80\x18\x55\x8d\x78\x14\xe9\xe2\x64\xd3\x84\xdb\x8b\xb1\xf0\xcd\x96\x29\x1d\xeb\xc2\xc7\x3b\xb9\xa2\x6a\x8e\xd3\xad\x95\x05\xaf\xd4\xa9\x19\x55\x85\x05\xa5\x7b\xc7\x95\x2c\x9d\x48\x9e\xa4\x39\x6c\x95\x96\x3c\xb3\xcc\xa0\x70\x27\xff\xb8\xd2\x67\x91\xc9\x93\x3f\x97\xb5\x42\x0d\x24\xa3\xa7\xc4\xf7\x23\xc9\x97\xc0\x9a\x26\x4e\x1a\xe1\x38\xf7\x69\x71\x45\x70\x5f\xad\xff\xbf\x23\x31\xeb\x23\x4b\xe3\x31\x42\x26\xce\x5a\x78\xe5\x53\xde\x3d\xaf\xd1\xcf\x47\xe2\x34\x82\x31\x8d\xdd\x24\xc1\xca\xd1\x9a\x1f\xe8\x6d\x43\x0b\xd1\x80\xb3\x4d\xb0\xee\xbd\x03\xa1\xdc\x7d\xb5\xb1\x37\x06\xe7\x22\x07\xfd\x5e\x22\xd2\x8d\xbd\x32\x61\x0b\x7d\x0e\x5c\xf0\x6c\xce\xa7\xe6\x0c\x89\x8a\x39\x83\x9a\xb1\x07\xc3\x09\x4e\x23\xc8\xa2\x0c\x26\xde\xef\xbb\x05\xca\x66\x4b\x33\x54\xdd\x77\x56\x8a\xf7\x0a\x5b\xef\xf3\xe1\x0c\xa6\xa2\xcd\x66\x35\x15\x3c\x23\x6e\x94\xd6\xde\x44\xb8\x3f\x8f\x51\x2c\xd1\x17\x63\x04\xf3\x64\xbc\x7f\x37\x13\x6f\x36\x37\xfe\xf4\x7b\x38\x3f\xc1\x35\xc5\xa5\x38\xca\x98\xf2\xa5\xcd\xbd\x0d\x7b\xb3\xb3\x45\x91\xf1\x5e\xe9\x24\x3f\x3e\xf0\xf9\xce\x6b\x04\xd2\x98\x8b\x5c\xa1\x5e\x8e\xc1\xb9\x69\x3b\x13\x0b\xd9\xa9\x7c\x46\x2f\x64\x2f\xc5\x6b\xa4\xc1\x19\x78\x6c\x0b\x03\x21\x76\xa9\x7b\x67\xb8\xb9\x03\xf9\xc7\x0e\xeb\x53\x68\x4f\x8f\xc0\xb3\x77\xc9\x7c\xbf\x97\xfb\x16\x89\xf8\x1b\x61\x12\x37\xd4\xa7\xa9\xd5\xbf\x72\xfe\x48\x1c\x6e\x91\x95\x53\x6a\xfa\x45\xfa\xa1\x7e\x33\xae\xd9\xcf\x55\xb5\x3f\x11\x1c\x62\xc1\xc1\xcd\xd6\xa5\xf8\x4f\xbc\x78\xe3\x7c\xf7\x1d\x1b\x45\x29\xe1\xc1\x2e\x29\x03\x9f\xcb\x7f\x32\xfb\x2c\xeb\x9d\x52\x50\x1e\xe8\xa7\x32\x31\x96\x64\x33\x27\x4b\x11\x91\x8b\xcd\xd3\xf5\xa1\x93\x79\x02\x5d\xd4\x04\xc2\x9b\x0e\x52\x5f\x82\x1f\x7d\x55\xe2\x79\xf8\x5a\xc4\x2c\x66\xb7\x97\x6a\x1f\xc8\x66\xfc\xcd\x4c\xb9\x0c\x46\x23\x8d\x3d\x98\x36\xe7\xe2\xfc\x58\x7c\x07\xb8\xa2\xac\x67\x64\x6a\x7b\x49\x92\x2e\x80\xb3\x3a\x9e\x00\x01\xae\x0c\xff\xb0\xa7\x08\xf1\x77\x4f\xed\x0a\x61\xce\x5d\xab\x9c\x9a\x7b\xc9\x10\x30\xbf\xc5\xb1\xaf\xf2\xf3\x15\xbd\x79\xad\xb6\x3b\xb8\x0f\xd7\x75\x1c\x5d\x94\xe5\xf0\x30\x75\x7c\x26\x49\xe5\x28\xaa\xd7\x63\xb1\xb5\x83\xb3\xe4\x54\x97\xc2\xa0\xe3\x77\x89\x73\x48\xb7\x6e\x71\xec\x6f\x92\x45\xe6\xe7\x58\x8a\x4b\x24\xfa\xe6\xd5\x03\x18\xde\x45\xb6\xfb\x8a\xb9\x38\x9f\x89\x57\xbe\xe6\x33\xe8\xa5\xaf\xc7\x61\xcf\x43\x55\x8a\xb9\xcc\x9c\x39\xc4\x97\x78\x99\xec\xc1\xfc\x25\xf0\x15\x31\xb9\xfb\x2e\xdb\x42\x4e\x8f\xa3\xc7\x18\xb6\xb2\x5c\x16\x6a\xf3\x38\xbc\x95\xe2\x29\x9f\x97\x90\x63\xff\x1d\x8d\x87\x71\x14\xc7\x55\xba\x47\xc3\x77\xde\xa6\xf2\x37\x87\x9a\x25\x7a\xaf\xe8\x3a\x06\x87\x49\x6c\xe5\xc6\x6d\xce\xdb\x4b\x93\x2f\xaa\xcc\x10\xe2\x08\x7e\x3b\xc0\x53\xc4\x71\xc5\xe8\xc8\xc5\x7a\x34\xed\x56\x50\x6c\xa1\xde\xfc\x0b\x4f\x77\xee\x63\x34\x0d\x11\x2a\x8a\x85\x6c\xfb\x50\x85\x16\x12\x88\xad\x45\xa4\x2e\xdc\x04\x80\x15\x78\x3f\xdc\x0e\xf2\x70\x17\x73\x9c\x32\xca\xe2\x08\x83\x28\xdc\xc5\xe7\xac\xe7\xfb\x27\x75\xb9\x58\x0b\xc3\xfe\xd4\xad\xba\x38\xca\x20\x86\x72\x51\x6e\x8c\xe8\x48\xdc\xa6\xa1\x2e\x0c\xdf\xca\x5a\x72\x04\xf9\xb1\x8d\x21\x86\x7a\x9f\x78\x33\x1b\xdd\x6c\x6e\x5a\xde\xeb\xb2\xfd\x97\xa5\x1c\x5f\xd1\x49\x0a\xc5\xec\x27\x1a\x94\x17\x26\x70\x3d\xe5\x17\x8c\xf6\xd0\x7f\x84\x46\xa1\x24\x11\xd8\xf2\x42\xcc\x2d\xf4\xa1\x99\x0b\xfb\xb7\x48\x93\x46\xac\x50\xac\xb4\x46\xe5\xe5\x0b\x17\xa4\x3e\x4d\xa6\xcd\x1b\x3b\x8b\xe4\xc8\x5c\xd1\x8d\xa3\xde\x5e\x84\xf0\x19\x43\x3b\x89\x3d\x35\x01\xae\x3a\xc0\xe3\x48\xe3\x29\xd4\x91\x46\x78\x1e\x89\x32\x32\x14\xe4\x75\xb9\xc4\x8e\x37\x7d\xed\x22\x2e\xc5\x7b\xf1\x24\x16\x4d\xb6\x3f\xc3\x6c\x76\xf1\xef\x9d\xea\x07\x9b\xad\x6e\x62\x19\x79\x35\xe8\xde\x0a\x4e\x47\xe7\x72\x17\xec\x21\xc7\xc3\xf0\x08\x4c\x0e\x67\x69\x2f\x78\x3c\x02\x87\xa9\xef\x8d\xcc\xe0\x34\x0d\x36\x87\x63\xff\x9d\xae\x47\xe0\xd1\x47\x94\xc5\xd5\xe6\xd5\xb1\x05\xac\x1c\xb3\x5f\xe3\xaf\x98\xcd\x61\x2c\xbb\x67\xc3\x3a\xbb\x23\x6c\xec\xed\xa2\x8a\xed\x6d\x87\xd5\x85\x19\xdb\xdb\x29\x85\x04\x50\x41\x9b\xb0\x36\x5c\x6f\x17\x25\xd3\x7c\xdb\x9b\xc5\x1c\x9c\x85\x01\xf3\xe9\xa9\x82\x1c\xa8\xe9\x36\xf8\xfe\x9f\xff\x80\x13\xdb\xd4\x95\x48\x69\xd5\xc9\xe5\xa5\x83\x56\xce\xd9\xd9\x39\xc8\x06\x94\x4d\xa5\x1c\xa0\xbf\x95\x91\x0d\x2a\x99\x8b\xc9\xd4\x29\x45\x3e\x06\x9a\xcf\x40\x0c\x34\xc1\x42\xb8\xdd\xe6\xb9\x5c\xf0\x13\x90\x64\x5e\xe5\x47\xc4\x06\x0e\x99\xe8\x32\x31\xba\x9d\x15\x2d\x34\x29\x6f\x53\x31\x84\x07\x6e\x58\xa5\x62\xcb\x67\x2d\x6f\xa3\x2a\x81\xce\x2b\xd8\xf3\x0a\xf8\x8e\xcb\x66\x12\x6f\x09\x86\xa3\xb5\x80\xbb\xc5\x9f\xa5\xcb\x6f\x35\x45\x54\x23\x55\x40\xad\x9b\xdf\x53\x84\x1b\x90\x05\xad\xfe\x40\xe8\x5c\xf5\x36\x85\x61\x60\x20\xb4\x84\x81\xd0\x6b\x08\xc3\x44\x41\x84\xf7\xb4\xdf\x03\xe3\xbb\xa6\xab\xc6\x81\x30\x1c\x0d\x3a\x8d\x91\xfb\x53\x53\xe8\x0a\x23\x01\x34\xf8\x61\x83\x6f\x0a\x39\xd5\x75\x0a\xb2\x13\x5f\xc5\xc4\x0a\xf5\xf1\x94\x11\xa7\x53\x50\x3a\x97\xc5\x49\x5c\x3f\xc9\xd5\xf4\x54\x65\x05\xae\xbd\xa0\xce\x30\x53\x13\xc1\x0a\xdf\x7f\x5d\x0f\x51\x3e\xd2\xb4\x10\x2e\x9e\xe6\x1b\x4c\x35\x0d\xec\xae\xb5\xff\x17\xd5\x90\xc1\x4c\x5c\x17\x29\xbb\x03\xc7\x35\x8a\xe4\xca\xef\xbf\x41\x21\xd9\xa6\xb1\xb3\xb4\x5e\x68\x1d\xbe\x26\x46\x53\x04\x54\x53\xd7\xcd\xa5\x66\x4c\x40\xb3\xd9\x05\x9a\x0d\x24\x68\x6b\x32\xd4\xf5\x35\x80\xc6\x1a\xcc\xa0\xa1\xcd\x17\x7a\x90\xf0\x38\x53\xe8\x80\x29\x9c\xcf\x91\x01\x1c\x13\x38\x53\x04\xfc\x57\x11\x03\x5b\x73\x93\xeb\x4d\x41\x3b\xa0\x6a\x7f\x82\x8e\x0a\xd6\xe6\x02\x18\x08\x29\x2e\xb4\x66\xc8\xfa\x42\x41\x2e\x61\x68\x80\xc5\x5c\x81\x0e\x02\xa6\x1a\x62\x50\x4d\x0b\x38\x53\xcd\x06\xb6\x8c\x0c\x68\x69\xa6\x57\x9c\x82\x0c\xc5\x23\x73\xb2\x98\x9f\x80\xb9\x69\x79\xc8\x55\xcb\x9c\x01\x03\x2d\x91\xed\x44\x48\x42\x07\xb8\xd0\x53\x64\xa1\x73\x60\x3a\x53\x64\x2d\x35\x1b\x9d\x03\x07\xd9\x8e\xed\x52\x5d\x6a\xba\x0e\xac\x85\x01\x34\xc3\x31\xc1\xdc\x74\x90\xe1\x68\x50\x07\xc8\xb2\x4c\xcb\x06\xcb\xa9\x2b\x95\xfb\x8f\x22\x45\xd0\x2e\xe6\x17\x8a\xb9\x34\x6c\x00\x2d\xe4\xb5\x86\x0b\xc7\x9c\x41\x27\x50\x92\xb4\xf6\xf8\xf3\x88\xfc\xe9\x52\x89\x75\xf9\x66\x59\xd6\xed\xe3\xe0\x85\x6f\x60\x24\x3c\x8d\x7e\x64\xd4\x12\xba\x91\x74\x00\xb6\x5b\x40\x58\x1f\x0d\x04\xe1\x34\x78\xee\x76\x63\x1a\x29\xbf\x70\xb3\x2c\x3d\xaf\x0c\x34\x9d\x68\xb4\x02\x34\x97\x72\x74\xc6\x2e\xa0\x9b\x98\xff\x23\x54\x77\xa7\xfd\x5c\x9a\x41\x76\x51\x40\x2e\x92\x9e\x6c\x29\xc5\x12\x93\x5c\x22\x25\xca\xe2\x9b\x83\xfe\xdd\xf6\x7d\xf0\x19\xed\x73\x0b\xcb\x77\x30\x78\x3f\x04\x7d\x1a\x89\x5e\x64\x68\xcb\x50\x41\x21\x40\x6e\x31\x55\x1c\xa8\x70\x11\x22\x07\x3a\xbe\x7e\x1d\x03\x8c\x57\xa8\x16\x4a\xee\x77\x56\xe8\xb1\xbd\x37\x04\x82\x0f\x68\xc9\x53\x68\x9d\x32\xdc\x59\x70\x7c\xd1\x85\x89\x94\x29\x66\xc0\xfd\xc8\xef\xa6\xc0\x2e\xcc\x85\x25\xef\x87\x29\x4c\xba\x3c\x8e\xfd\x5d\x9f\xcc\xf6\xae\x33\x05\xb3\x89\x16\x3a\x3e\x0e\xc4\x6d\xb0\xd3\xf2\xaa\xff\x84\xa7\xce\x70\x34\xf4\x37\xce\xe0\x64\xe2\x6d\x9e\xd9\x0e\x9c\xcd\xbd\x17\xfe\xed\xee\x9f\x89\x0c\x86\x61\x58\x18\x01\x5b\x9a\x71\xba\x69\xe1\x3b\xf0\x08\x4d\x1a\x0b\x49\xfa\x62\x24\xde\xea\x07\x4e\x3d\x43\xd3\x14\xe0\xe6\x4f\x9b\x5a\xc4\x73\xf0\xfd\x3b\x98\xa2\xd5\x77\x64\xb8\x3d\xa8\x80\x3b\xd3\xd4\x3b\x4d\x0f\xd6\xcb\xac\xec\x19\x74\xd3\xf5\x48\x0b\xef\x99\x8a\x90\xeb\x41\xd1\x04\x59\x89\x27\xde\x18\x76\x87\xb0\x3f\x69\x01\x49\x9b\x44\x9b\x83\x46\x5b\x68\xdc\x80\xd3\x24\xd8\x7f\x00\x76\xe6\x23\xb0\xa7\xd0\xca\x6a\xdc\x14\x5a\xfc\xb8\x3b\x02\x98\x8f\xe6\x34\x0a\xfb\x9f\x9f\x1b\x14\xbe\x55\x5a\xc8\x46\xd6\x07\xb2\xc1\xab\x6d\x1a\x52\x82\xcd\xd4\x05\x9e\x74\x89\x14\xa4\x23\x07\x29\x40\x32\x4d\x1d\x41\x63\x97\x1b\xef\xe5\x69\x3e\x6c\xf2\xb0\xc7\x17\xb7\x9f\x62\xa6\x90\xe8\x17\x2f\x8f\x8c\xb3\xdb\xef\xed\x74\x9e\x6f\x01\x13\xcd\x38\x4d\x13\x4d\x9c\x43\x67\x2a\x9a\x73\xfb\xec\x47\x92\xd6\x07\x4a\xbe\xde\x31\x1b\xbd\xe7\x06\xc1\x69\x20\xee\x79\xaa\x8a\x22\xe2\x6c\xee\xe9\xdc\xb8\x89\x84\x64\xfe\x15\x9b\x9e\x5a\x86\x23\x7e\x30\x02\x8f\x9d\x51\x1b\xe0\xde\x0f\x9d\x5e\x63\x20\xdc\x0a\xbd\x11\xa8\x3f\x07\x3f\xf5\xfa\xe0\xb6\xd3\xf3\xce\x0e\x6f\xbe\xf3\x4f\xdb\xef\x0d\xbe\xd1\x16\x00\xbe\x65\x20\x3e\x5c\x33\xed\x3d\xcb\x86\x0c\xb4\x8a\xdf\x15\x9a\xce\xff\xc9\xe5\xa5\x85\x26\xb2\x0e\x6d\x3b\xb0\xae\x38\x9c\x98\x1c\x52\xd1\x2e\xcf\xdb\x97\x48\x50\xdb\xdd\xc1\x4b\xed\xa4\xe8\x6a\xed\x5e\x44\x76\xb9\x2f\x4b\x73\xa7\xe5\x59\x56\x5f\x6c\xe7\xca\xf4\x5e\x49\x2b\x58\x48\xf6\xd3\x79\x0c\x72\x97\xeb\x04\x78\x49\xad\x67\x72\xe6\xeb\xdf\x4e\xaf\x32\xcc\x55\x4b\xaa\x30\xe7\xd9\x9c\x27\x07\x69\x05\x06\x63\x24\x8e\xc3\x69\x66\x1f\x46\xe3\x95\xfc\x5e\x4c\x6c\xf1\xfc\x96\x7e\xcc\xe1\x2e\xa5\x27\xf3\x64\x29\x51\x5b\xb8\x7f\x6f\x16\xb0\x99\xbd\x39\x76\x20\xc7\x45\xd1\x79\xba\x0b\xcb\x8f\xd3\x53\x1d\x47\x56\xc4\x9e\xea\x2b\x22\x71\x63\xbc\x26\x6e\xe7\x49\xa2\x42\x2d\x33\xae\x74\xb3\x76\xaf\x6d\x58\xf0\xe6\x5b\x5b\xc6\x9f\x8f\x24\xb1\x92\xe4\xb7\x8f\x5b\x6b\x6e\xfb\xdd\x75\x87\x2a\x28\x9a\x4d\x9f\x81\xac\x81\x50\xd8\x7a\xa3\x9a\x7d\x11\x24\x1a\x06\x91\x5c\x32\x4c\x89\x95\x94\xe6\xce\x19\xb1\x52\x2f\xbf\xf7\xd3\x1b\x25\x87\x4a\xb2\xda\xb2\x2a\x95\xcc\x76\xbb\xb1\x31\x1e\xb5\xb0\x4e\x2b\x0c\xc4\x23\x9b\x4c\x99\x00\xd1\x13\x5c\x9b\xe5\xa3\x3b\xff\x3c\xd1\xf0\xbe\x0b\xdc\x04\xd9\x95\x17\x28\x8b\xd9\x1c\xc8\xe6\x6c\xee\x86\x4f\x2e\xdc\xff\x0b\x00\x00\xff\xff\x52\xe4\x05\x84\x10\xe4\x00\x00") +var _baseHorizonSql = []byte("\x1f\x8b\x08\x00\x00\x00\x00\x00\x00\xff\xd4\x7d\x79\x6f\xe2\x48\xf3\xf0\xff\xf3\x29\x5a\xa3\x95\x92\x3c\x93\x99\xf8\xc6\x64\x7e\xb3\x92\x03\x26\x90\x10\x20\x1c\xb9\x56\x2b\xab\x6d\xb7\xc1\x89\xb1\x89\x8f\x00\xb3\x7a\xbe\xfb\x2b\x5f\x60\x1b\x9f\xc0\xcc\xb3\x2f\x5a\xcd\x06\x5c\x5d\x57\x57\x57\x77\x55\x57\xb7\xbf\x7e\xfd\xf4\xf5\x2b\x18\x18\x96\x3d\x35\xd1\xe8\xbe\x0b\x64\x68\x43\x11\x5a\x08\xc8\xce\x7c\xf1\xe9\xeb\xd7\x4f\xee\xf3\xa6\x33\x5f\x20\x19\x28\xa6\x31\xdf\x02\x7c\x20\xd3\x52\x0d\x1d\xd4\xbf\x31\xdf\xf0\x08\x94\xb8\x06\x8b\xa9\xe0\x36\x4f\x80\x7c\x1a\xf1\x63\x60\xd9\xd0\x46\x73\xa4\xdb\x82\xad\xce\x91\xe1\xd8\xe0\x07\xc0\xbe\x7b\x8f\x34\x43\x7a\xdb\xfd\x55\xd2\x54\x17\x1a\xe9\x92\x21\xab\xfa\x14\xfc\x00\x27\x93\x71\x8b\x3d\xf9\x1e\xa2\xd3\x65\x68\xca\x82\x64\xe8\x8a\x61\xce\x55\x7d\x2a\x58\xb6\xa9\xea\x53\x0b\xfc\x00\x86\x1e\xe0\x98\x21\xe9\x4d\x50\x1c\x5d\xb2\x55\x43\x17\x44\x43\x56\x91\xfb\x5c\x81\x9a\x85\x62\x64\xe6\xaa\x2e\xcc\x91\x65\xc1\xa9\x07\xb0\x84\xa6\xae\xea\xd3\xef\x01\xef\x08\x9a\xd2\x4c\x58\x40\x7b\x06\x7e\x80\x85\x23\x6a\xaa\x74\xee\x0a\x2b\x41\x1b\x6a\x86\x0b\xc6\x75\xc7\xfc\x10\x8c\xb9\xab\x2e\x0f\x3a\x2d\xc0\x3f\x75\x46\xe3\x11\xe8\xf7\xba\xcf\x01\xfc\xb7\x99\x6a\xd9\x86\xb9\x16\x6c\x13\xca\xc8\x02\xcd\x61\x7f\x00\x1a\xfd\xde\x68\x3c\xe4\x3a\xbd\x71\xa4\x51\x1c\x50\x90\x0c\x47\xb7\x91\x29\x40\xcb\x42\xb6\xa0\xca\x82\xf2\x86\xd6\xdf\x7f\x07\x41\xc9\xfb\xeb\x77\x90\x74\xed\xea\xf7\x09\xe8\x53\xab\x2e\x9d\xcf\xa0\x6b\xc8\x79\xc4\x22\x50\x5b\xe4\x1e\x78\xa7\xd7\xe4\x9f\x22\x90\x01\x5a\xdb\x74\x2c\x5b\xd0\x54\xdd\x65\x6d\x2d\xd8\xeb\x05\x12\x24\x43\x46\x82\x6a\x59\x0e\x32\x2b\x35\xde\xa3\xc9\x56\x11\x45\xcd\xa0\x8c\x04\xa4\x28\x48\xb2\xbd\x86\x86\x29\x23\x53\x10\x0d\xe3\x2d\xbf\xa1\xa5\x4e\x75\x64\x46\x69\xe5\xc3\x1b\x8a\x12\x80\x5b\x48\xd3\xdc\x81\xed\xa9\xb4\x4a\xa3\x22\x15\x6c\xa1\x35\x68\xd9\xc2\xdc\x90\x55\x45\x45\xb2\xa0\x21\x79\x5a\xbe\xad\xe8\xac\x4b\x72\xa7\xea\x32\x5a\x09\x11\x33\xd4\x2d\xe8\xb9\x24\x4b\x30\xf4\x42\xcd\xc7\x5b\x1b\x0b\x64\xc2\x4d\x5b\xd7\x5a\x0e\x68\xbd\xe5\xe4\x20\x2e\xaa\xb5\xf5\xb5\xec\x35\xb4\xd0\xbb\x83\x74\xa9\x92\x08\x91\xe6\x0b\x13\x7d\xa8\x86\x63\x05\xbf\x09\x33\x68\xcd\xf6\x44\x75\x38\x06\x75\xbe\x30\x4c\xd7\x71\x06\xb3\xdf\xbe\x68\xf6\xd5\xa5\xa4\x19\x16\x92\x05\x58\xc9\x16\xc3\xf1\xbc\x87\x29\x05\x83\x79\x0f\xa6\xa3\x2d\xa1\x2c\x9b\xc8\xb2\xf2\x9b\xcf\x6c\x53\xf6\x56\x08\x82\x66\x18\x6f\xce\xa2\x04\xf4\xa2\x88\x25\x1f\x0a\xaa\x66\x45\xc4\xe1\xf4\x58\xba\x81\xeb\x2a\x5d\x9f\x51\x0e\x34\x44\xbf\x47\x93\x52\xde\x35\x6c\xe4\x4d\x82\x15\x88\x44\x27\xcd\xa2\x16\x0b\xb7\xc1\xcc\x2e\xec\x01\x2b\xe6\x80\xdc\xe9\xab\xb8\x45\x30\x4e\xcb\x00\x1b\x3e\x1f\x46\x21\xa0\x6a\xd9\x82\xbd\x12\x16\xc5\x28\x5d\x48\x63\x51\x16\x12\x95\x05\x0b\x67\xd3\x7c\x60\xb4\x5a\x08\xd1\xd5\x45\xc9\xf9\x3e\xa5\x99\xbb\xbc\xc8\x6f\x24\xae\x4b\x4d\x86\xae\x7e\x0b\x3d\x66\xd9\x89\xdf\x67\xb2\xa4\x54\x1b\xe0\x62\x59\x36\xee\x46\xd5\x15\xcd\x9b\xb4\x04\x19\x59\xb6\xaa\x7b\x7f\x97\x6c\x3b\x33\xe6\x48\x90\x8d\x39\x54\xcb\xb6\x70\x03\xa6\xe8\x32\x53\x87\x73\x54\x66\x99\x19\x59\x9f\xe5\x2c\x33\xa3\xab\xb8\x45\xc9\x05\xac\xbf\x74\xc9\x41\x1a\xac\x6d\xca\xe2\x7b\x43\x6b\xe1\x03\x6a\x0e\x12\x5c\xbf\x8e\x72\x10\x27\x20\x4b\x53\x48\x59\x32\x09\x0b\x68\xda\xaa\xa4\x2e\xa0\x9e\xbb\x0e\x2f\x6a\x5a\x99\x87\xcd\x92\xa7\x2a\x07\xe9\x0d\x2b\xd3\xf7\x2c\xbe\x0c\x3d\x1f\xf0\x97\xe3\xf7\x47\xa0\x17\xa9\xf8\x7f\x7a\x91\x4b\x10\xc5\x79\x23\x58\x28\xc9\xc1\xd4\x30\x17\xc2\x5c\x9d\x06\x2b\xca\x1c\x16\x12\x90\xa5\x65\x4c\xf8\xc0\x1c\x0a\x49\x6f\x59\x96\x42\xf5\xe0\xb0\x34\xe6\xd0\xa1\x04\x81\x54\x1e\xfa\x04\x68\x65\x1a\x65\x70\x57\xe6\xdb\x75\x84\x65\x10\x7b\x0e\x33\x0f\x7b\x59\xa7\xe0\xb7\x6e\xf4\xbb\x93\xbb\x1e\x50\x65\x9f\x76\x93\x6f\x71\x93\xee\xb8\x24\xee\x8c\xc1\x7e\x04\xcc\xc1\x30\xcb\xc7\xe4\x7d\xcb\x40\x14\xf1\xfc\xf9\x80\xbe\x37\xcf\x87\x49\x38\xe6\x7c\xe0\xb4\x00\x36\x68\x31\xe2\xef\x27\x7c\xaf\xb1\x47\x6f\xb9\x53\xa3\x85\xde\x2b\x53\x8e\x21\x29\xdd\x5a\x46\x65\x42\x0d\x38\x9d\xba\x16\xb0\x89\x0a\xed\xe2\x35\x64\xd8\x4c\x74\xa4\x37\x64\xc7\xa3\x83\x52\x6c\x09\x0c\x86\x61\x58\xd0\xa2\x35\xe9\x35\xc6\x9d\x7e\x2f\xa5\xf7\x0d\x61\xae\x6a\x9a\x6a\x9d\xba\x61\x8b\x65\xc3\xf9\x02\x2c\x55\x7b\x06\xdc\xaf\xe0\xa7\xa1\xa3\x73\xa0\x3b\x73\x64\xaa\xd2\xd9\xde\xc8\x0c\xc7\xce\xc1\x57\x76\xe8\x94\xb7\x8d\x8c\x19\xb2\x8a\x65\xa4\xa3\x28\xd7\x36\x08\xa2\xcb\x01\x07\x11\x73\x69\xd9\x82\xd9\xb2\x8a\x2c\x7e\x93\x92\xb0\x81\xf7\x2c\xcf\xcf\x66\x35\x5c\x82\xa3\xc4\x7c\x9b\x0f\x9c\x98\x3a\xf3\x81\xcb\x03\x26\xe6\xb4\x92\xd0\xee\x64\x52\x0e\x34\x80\xe2\xae\xaf\x87\xfc\x35\x37\x4e\x81\x9c\xab\xba\xb0\x30\x55\x09\x9d\x06\x23\xe1\xaf\xbf\xcf\x4a\xb4\x82\xab\x3d\x5a\x69\xd0\xb2\x4f\xa1\xbe\x46\x9a\xb7\x5b\x52\xa2\x85\xa2\x9a\xa9\x4d\xb2\x87\xfd\x46\x1e\xd7\x63\x6d\xb9\xdb\x0c\xf4\x2d\xa3\x39\x38\x42\xe9\x0e\xc0\xe1\x25\x5f\xdd\xe6\x5b\xe6\xcf\x41\x15\x41\x3c\xd1\x4b\x60\xe0\x9f\xc6\x7c\x6f\x94\x40\xa1\x2d\xa6\xd6\xbb\x16\x8e\x9b\x46\x9b\xbf\xe3\x76\x28\x7c\xff\xe4\x6f\x94\xf5\xe0\x1c\x5d\x86\xbf\x81\xf1\x7a\x81\x2e\x83\x26\xdf\xc1\x48\x9a\xa1\x39\xbc\x04\x5f\xbf\x83\xfe\x52\x47\xe6\x25\xf8\xea\xed\x9f\x35\x86\xbc\xdb\x5f\x01\xe6\x10\xdf\xa7\x18\xc6\xf8\xc3\x00\x71\xa3\x7f\x77\xc7\xf7\xc6\x39\x98\x7d\x00\xd0\xef\xc5\x11\x80\xce\x08\x9c\x84\x3b\x63\xe1\x6f\x96\x87\xe4\x24\x49\x39\x14\x3f\xa0\xb9\xd1\x50\xa1\x3c\x31\x5d\xf6\xfa\xe3\x84\x3e\xc1\x63\x67\xdc\xde\xb0\x15\xdd\x22\x8b\x91\xdf\x62\x49\x30\x52\x45\xf8\x1d\x24\x9e\x02\x06\xdd\x8b\xc5\x74\x74\xdf\x05\x0b\xd3\x90\x90\xec\x98\x50\x03\x1a\xd4\xa7\x0e\x9c\x22\x4f\x0d\x25\xb7\xf4\xa2\xec\x16\x1b\x5a\xc0\x7e\x68\xab\x5b\xfe\xc3\xbe\x4d\xd3\xe5\xc6\xb2\x0b\xf1\x83\x21\x3f\x9e\x0c\x7b\xa3\xc8\x6f\x9f\x00\x00\xa0\xcb\xf5\xae\x27\xdc\x35\x0f\x3c\xe9\xef\xee\x26\xbe\xb3\x1b\x8d\x87\x9d\xc6\xd8\x83\xe0\x46\xe0\x0f\xe1\x0f\x30\xe2\xbb\x7c\x63\x0c\xfe\xc0\xdd\x6f\xc9\xde\x28\x1c\x88\x87\x49\x57\x84\xfe\x68\xc2\x11\x69\xc2\x95\xf1\x54\x87\xc9\x57\x82\xc2\x46\xc4\xcd\x4f\x7b\x49\x78\xfa\x09\x80\x06\x37\xe2\xc1\x63\x9b\xef\x81\x3f\xf0\xbf\xf0\xbf\x2f\xfe\xc0\xff\x22\xfe\xfe\xf3\x0f\xc2\xfb\x9b\xf8\x8b\xf8\x1b\x8c\xfd\x87\x80\xef\x8e\x78\x57\x29\x7c\xaf\x79\x96\xaa\x99\x12\xf3\xc0\x81\x9a\x29\xa6\xf0\xab\x35\xf3\x7f\xfb\x68\x66\x77\x4e\x0d\xf4\xb0\x99\x87\xcb\x29\x62\x3b\x6d\xef\x60\xf4\x38\x06\x60\xe4\xea\x0a\xfc\xd8\x7a\x80\x73\xff\xe7\xf1\xf3\x80\x07\x3f\xa2\x23\xe2\x2c\x6d\xd4\x1e\x95\xc7\x24\xc2\x04\x8b\xe1\x30\x2e\xcf\x61\xea\x12\xe8\x50\x2e\xd3\x90\x26\x38\x8d\x0d\xc8\x38\xbb\x5b\x2b\xdb\xe5\x36\x6d\x99\x77\x30\xb7\x29\x48\x93\xdc\x46\x07\x49\x2e\xb7\xee\xcc\x25\x23\x05\x3a\x9a\x2d\xd8\x50\xd4\x90\xb5\x80\x12\x02\x3f\xc0\xc9\xc9\xf7\xf8\x53\x37\x8a\x13\x0c\x55\x8e\x54\xbb\xc4\x64\xdd\x2c\x7e\x03\xf9\xbc\xd1\x55\x4e\x36\x7f\x20\x6e\x32\x46\xbe\x2c\xdb\x3c\x37\x90\x66\xd0\x84\x92\x8d\x4c\xf0\x01\xcd\xb5\xaa\x4f\x4f\x69\xe6\xcc\x5b\x29\xf4\x26\xdd\xae\x2f\x9f\x08\x35\xa8\x4b\x08\x88\xea\x54\xd5\xed\xe4\x43\x7f\x5f\x5d\x53\xa1\xa8\x6a\xaa\xad\x22\x2b\x1d\x2e\x2c\x0f\x28\x01\xe8\xef\x32\x0b\xba\x33\x17\x91\x99\x0e\xa4\x3b\x73\xc1\x72\x44\xa4\xdb\xa6\x8b\x48\xd5\x6d\x34\x45\x66\x02\x28\x75\x07\xa1\x94\xc4\x8a\x06\xa7\x59\x58\x23\x7b\x0b\x29\xb8\x48\x22\x89\x6b\x0e\x2d\x1b\x99\xc2\x12\xa9\xd3\x99\x0d\xac\x39\x74\xf5\x90\x94\xc7\x9e\x99\xc8\x9a\x19\x9a\x2c\x68\xc6\xb2\x18\x68\x8e\x64\xd5\x99\x17\xc3\xcd\xd4\xe9\x2c\x0b\x2a\xad\x98\x62\x47\xe4\xdd\x71\x17\x8f\xd9\x0e\x35\x48\x3f\xdd\xe8\x5b\x65\x90\xbe\x79\x43\xeb\x14\xbd\xe2\x34\x96\x54\x6c\x45\x2b\xd6\xe1\x1c\xa5\x00\x32\x54\x12\xd0\xcb\xb0\xa5\x40\xd6\x77\x38\x38\x54\x85\x61\x90\x7c\xb0\x16\xc3\x64\x73\x89\xe1\xbd\x2b\xaf\xdf\x18\xd8\x68\x95\x34\x91\xc0\x66\xd3\xc7\x81\xb5\x30\x74\xcb\x30\xd3\x75\xef\x09\x1d\xf0\xea\x27\xe1\x76\xb2\xdd\xe2\x5a\x08\x51\xf4\x7b\xbb\xa2\x4c\x46\x9d\xde\x35\xb8\x1a\x0f\x79\xfe\x34\x80\xdb\x55\x64\x24\x2d\xb1\xb7\x0e\x23\x5b\x01\xbe\xfa\x54\x39\xdd\xe7\xc0\xb9\xcb\xe1\xae\xbc\x29\xae\x69\xe3\x6f\xd3\x55\xe7\xbb\x97\xac\xd1\x6b\xcc\xb5\x14\xa5\x12\x34\x7d\x96\x63\x53\xc9\x74\xce\xbe\xea\x48\xee\xbd\x04\x16\xb5\xd9\x32\xca\x90\x68\xbb\xbd\x94\x36\x76\x77\x7c\x62\x74\xdf\xa9\xd4\xe0\x0d\x74\x9f\x62\xa3\xb9\xea\xde\xd5\x53\x32\x47\xb6\xaf\x9e\x92\xbb\x60\x1b\xd3\x49\x61\x11\x2e\x16\x9a\xea\x15\xfb\x80\xac\x34\xf0\x2e\xa3\x59\x19\xc0\x30\x9f\x11\xa4\x0e\xcb\xf1\xbc\x49\x34\x66\x60\x0d\x96\x31\xdc\x70\xec\x67\x04\x70\xef\x87\x4e\xaf\x31\xe4\xbd\xf0\xfd\xea\x39\xf8\xa9\xd7\x07\x77\x9d\xde\x03\xd7\x9d\xf0\x9b\xef\xdc\xd3\xf6\x7b\x83\x6b\xb4\x79\x80\x17\x09\xb3\xb7\xda\x93\x88\x76\x86\x6c\xb0\x29\x03\x74\xb4\xb2\x3f\xa0\x76\x7a\x92\x21\xf1\xc9\xe5\xa5\x89\xa6\x92\x06\x2d\x6b\xc7\xd6\xfc\x22\xa7\x74\xdf\x19\x76\xd4\x86\x13\x49\x83\xea\xdc\x5d\xdd\x09\xc1\x32\xc9\x02\xa7\x73\xa8\x3b\x50\xd3\xd6\x2e\x2a\x24\x9f\x65\xf6\xc2\x6e\xdb\x5f\xd7\x1f\xa9\x6a\x4c\x63\x3e\xc3\x07\x66\x6b\x36\x53\x8a\xa8\x8e\x7d\xd5\xee\x80\x0a\xc9\x11\x13\x9d\x38\x26\xbd\xce\xfd\x24\x9c\x3f\x3e\xc7\xab\xd2\x52\x88\x7a\x95\x6d\x9f\xdd\xc9\x24\x47\x3c\x7f\x5a\x11\x6d\x13\x21\x70\xaa\xca\x67\xdf\xf7\x27\x96\x26\x4c\x25\xf2\x69\x08\xce\xb2\xba\x6a\xbb\x65\x92\xd9\x69\xbb\xa0\x59\x53\x59\x26\x87\x29\x2d\xca\xf6\x48\x1e\x83\x7e\xdf\x58\x31\xed\xe4\x0a\x14\xd3\x53\xaa\x5c\xe7\xb9\x42\x6c\xfb\x75\x2f\x5e\xa3\x94\x8e\xc8\x74\x66\xe7\x46\x77\x4a\x0b\xbb\x37\x5e\x07\xfc\xfb\x3a\x38\x9f\xc9\xb4\x2e\x2e\x10\x2b\x55\x5f\x09\xe9\x0e\xea\xe6\x62\x8e\xe3\xd4\x8e\xcc\xbc\x37\x55\x74\x7a\x23\x7e\x38\x06\x9d\xde\xb8\x9f\xe7\x18\x3c\x97\x3d\x02\xa7\xf8\x39\x38\xc1\x82\x0f\x5e\x63\x59\x82\x51\x44\x05\x91\x64\x1d\xe1\x0a\x2d\xd1\x24\x85\xd7\x24\x46\x41\xb2\x82\x08\x09\xa3\x11\x2b\x22\x09\xa7\x48\x8c\xc4\x29\x12\x49\x14\x23\x92\x6c\x9d\xc5\x45\xac\x2e\x91\x4a\xfd\xe4\xec\xfb\xa7\x20\xe1\xb6\xcd\x95\x7f\xb3\x50\x59\xf7\x7d\x0e\xf0\x73\x60\x9b\x0e\x3a\xfb\xee\xce\x78\xe3\x19\x02\xdb\xed\xe2\x8b\x68\x5d\x01\x80\x26\x02\x53\xc3\x5d\x0c\xdb\x06\x10\x11\x70\x74\x13\x69\xd0\x46\xb2\xfb\x7d\x43\x21\xcc\x24\x58\xe7\x40\x74\x6c\xa0\xda\x40\x36\x90\xa5\x9f\xd8\x60\x0e\x6d\x77\xa2\x55\x0c\x37\x0e\x71\x63\xf5\x69\xaa\xe2\x72\x87\xdf\x46\x85\x04\xcb\x52\x75\x8c\xae\xb3\xf4\x39\xc0\xcf\xbe\xef\x8f\x89\xa5\xd9\x7a\x9d\x64\x19\xb6\x9e\x8d\xa8\xc0\x4c\x76\x99\xa2\x0e\xc6\xb5\x61\x8b\xf5\x51\xa5\x2f\xb5\xfc\x6d\xe9\x83\x17\x5a\x7e\x01\xcc\x66\x55\x90\xb7\xfc\xf7\xe2\x83\x32\x11\xe7\xaf\x8b\x16\x72\xd6\xd1\xb1\x9d\xfd\x23\xad\xa2\xa3\x38\x7f\xdb\x1a\x3a\x4f\x10\xd0\x7f\xec\xf1\x4d\x70\xf5\x5c\x20\x91\x5f\xd0\x94\x2f\xd0\x06\x57\xe2\xf1\x37\x55\xce\xe2\x2d\x2c\xb7\x38\xd4\xea\x02\x3c\x89\x89\x2f\x92\xd7\xc8\x9d\xf4\x8a\xd7\x3f\x9f\xbd\x02\xee\xcf\x19\xd6\x9c\x13\xe7\xca\xc8\x86\xaa\x66\x81\x57\xcb\xd0\xc5\x6c\x63\x0b\x6b\x54\x0e\xd5\x43\x80\x27\xd0\x43\x98\x19\xcd\xe0\x2d\x72\x28\xa6\xd4\x28\x4c\x3b\x8f\x93\xde\x30\x50\x4b\xd4\x3b\x79\xe1\x78\xc8\x47\x18\x1a\x60\x09\x0a\x11\x27\x5b\x0a\x7e\x73\x28\x06\xe4\x54\x38\x25\xdb\x98\xc8\x9d\x67\x0a\x1a\xf9\xb0\xce\x42\x2e\x0d\xbb\x31\x9d\xe0\x6b\xe2\xbc\xd0\x8e\x2c\xf8\x4e\x1a\xc7\x86\x9a\x20\x19\xaa\x9e\x91\xe7\x56\x10\x12\x16\x86\xa1\x65\xa4\xd5\xa1\x85\x04\x05\x65\xf5\xb5\xf7\xd8\x44\x16\x32\x3f\xb2\x40\xe6\x70\x25\xd8\x2b\xc1\x4b\xe5\xa8\x3f\xb3\xa0\x16\xa6\x61\x1b\x92\xa1\x65\xca\x95\xec\xa3\xd0\x58\x10\x94\x83\xa4\x61\x90\x0e\x74\x24\x09\x59\x96\xe2\x68\x42\xa6\xa1\x04\x82\x43\x55\x43\x72\x11\x54\xc0\x7a\x86\x09\x65\x0f\xbd\x8c\xd2\xb2\x43\x47\x62\x46\x89\x69\xc1\xbc\x58\x3d\x22\xcb\xf6\x71\x55\x45\x3e\xee\x54\x97\x4b\xe3\x77\x4d\x7d\x95\x04\x3d\x70\x2a\xcc\xa5\xb5\x3b\x35\xa6\x83\xe7\x4c\x95\x91\xc2\xcb\xa3\xd9\x66\x51\x06\xbb\x4c\xe4\xe8\x25\x2b\x25\x5f\x14\x6f\x96\x3c\x70\x92\x0c\xbc\x83\xe1\x98\xd2\xe6\x48\x5a\xc6\xf4\x14\xba\x9c\x93\x93\xcb\xcb\xec\x2c\x7b\xf6\x38\x08\x2a\x86\x0f\x55\x67\x70\x42\xbd\x6a\x4e\x25\x7f\x4d\x11\xb8\xcd\x7d\x66\x38\xaf\x32\x3c\x93\x6c\xe2\x7c\x7c\x1e\x50\x70\x64\x3f\x0f\xc4\x4f\xb3\xa7\x02\xec\xde\x34\x50\x00\x97\x4b\x6e\x03\x95\x43\xd1\x63\x49\xb5\x82\x43\xe2\x40\x34\x0c\x0d\x41\x3d\x9c\xb7\x54\x09\x09\x7a\x6c\x8e\xf6\x7f\x8b\xcf\xdb\xdb\x93\x93\x42\x62\x46\x8f\x9d\xdd\x4c\x3e\x34\x0d\x47\x97\xbd\x6b\x2a\x34\x75\xb1\x80\x53\xb4\x8b\x54\xb5\x04\xb4\x82\x92\x1d\xe7\x2b\x72\x68\x22\xf5\x22\x03\x4f\x5c\xc1\xbb\xea\x02\x34\xda\x7c\xe3\x16\x9c\x9e\x46\x55\xff\xe7\x0f\x80\x9d\x9d\x15\xe1\x4a\x6b\x1f\xaa\xfb\xff\x76\x7a\xa0\x04\xbe\x58\x6f\x24\xd0\x27\xba\xca\xe7\xf0\x53\x56\xdc\x79\xd4\x41\xe8\x97\xd9\x7b\x43\x71\x3b\x5e\x02\x5b\xd1\x0d\x1b\xe8\x8e\xa6\xb9\xb2\xa5\xda\x77\x14\x20\xcb\x28\x77\x60\x36\xc3\x77\x07\xfd\x87\xa1\x39\x73\x14\x16\x79\xa4\x62\xcf\x01\x81\x1f\xd3\xd4\xdf\x67\xea\x74\x26\xe8\xd9\x8f\xe4\xd4\x47\x9a\xb1\xcc\x68\xe4\x3e\x49\x6f\x93\x3c\x22\x91\xa6\x02\x0f\x26\x1d\xb1\xf7\x28\x1d\xb3\xe7\xd4\x8a\x50\xfb\x40\xe9\xb8\xfd\x67\x69\xc8\x3f\x01\x30\x18\x76\xee\xb8\xe1\x33\xb8\xe5\x9f\xe3\x96\x7e\xbe\xd3\xab\xe7\x5b\x2b\x89\xed\x40\xf7\x87\x60\xc8\x0f\xba\x5c\x23\x52\xec\x16\x39\x4d\x91\x1b\x0c\x00\xdb\x74\xb6\x5c\x6f\x56\xfb\x67\x9f\xc0\xa6\x16\x2e\x90\x96\x1b\x81\x3f\xfe\xf8\x04\xc0\x15\x7f\xdd\xe9\x79\x03\xce\x07\x00\xb2\xfa\x71\x2a\x41\xcb\x3e\x3d\x45\x2b\xdb\x9d\xd5\x4e\xd1\xc2\x90\x66\xfe\x4d\x3d\xf6\x19\xf8\x0f\xc0\x5d\x2b\x3f\x03\x30\x0c\x15\xce\x7c\xb2\x67\xff\x71\xff\xfd\xfe\x09\x00\xbe\xd7\xfc\xfe\xe9\x8f\x3f\xb6\x85\x76\x9b\x1a\xda\xb0\xd8\x6e\x5f\x69\x8f\x2b\x6a\x84\xce\xe5\xe5\x86\x50\x20\x4d\x55\x41\xfc\x9c\x6e\xfa\x61\x9d\x44\xa6\x56\x46\xd6\x27\x10\xcf\xc9\x6e\x59\x49\xce\xbd\xe7\xe0\xc4\xf3\x2b\x27\x97\x97\xe1\x61\x99\x9d\x72\x85\xcc\x93\x45\xbb\x84\x03\x27\x15\x23\x9e\x6c\x95\xb7\x66\x49\x3f\x23\x75\x04\x07\x9a\x7e\xde\xae\x64\xc8\x52\x65\x97\x61\x9f\xa0\xa5\xe8\x84\xd9\x71\xc2\x96\x02\x2a\xbf\x2b\x70\xa9\x28\xec\x81\xa1\x4b\x01\xb5\xdd\xe0\x25\xab\x41\x4e\xf8\x12\x3b\x55\xb8\xaf\xad\xe6\x9c\x54\x0c\xcc\x34\xca\x59\xe9\xc4\x56\x30\xee\x0a\xd2\x65\x65\x03\x9d\xfc\x98\x25\xbd\x24\x6d\x43\x3a\x75\xd8\xcc\xe1\x2a\x27\xb5\x93\x95\x34\xfb\x9f\xa4\xbd\xec\x95\x80\xf4\x0f\xa4\x19\x0b\x94\x56\xd9\x62\xaf\x04\x13\x59\x8e\x96\x5a\x99\x63\xaf\x84\x39\xb2\x61\xc6\x23\x05\xa1\xcc\xc7\x96\x3a\xd5\xa1\xed\x98\x28\xad\x08\xa3\xce\x9c\xfd\xf5\xf7\x36\x56\xfc\xe7\xbf\x69\xd1\xe2\x5f\x7f\x27\x75\x8e\xe6\x46\xc6\x06\xc5\x16\x97\x6e\xe8\x28\x37\xf6\xdc\xe2\xda\x45\x13\x48\xa6\xce\x91\x20\xba\xd1\x83\x57\x8d\xc4\x9a\x50\x9f\xa2\x98\x59\xa6\x3f\x9c\xab\xba\x90\x61\x3d\xd9\x00\x42\x32\x30\x49\x05\x0a\xe8\x4e\xe1\x22\x06\xeb\xad\x45\x36\xe5\x76\x6e\x2f\xfc\xf5\x77\x32\x95\x17\x8f\x6d\xdc\x2e\x73\xc5\x9e\xa2\x44\x6e\x54\xd7\xdd\x69\xae\xd4\x50\xdd\x62\xca\x1d\x57\x51\xc4\xc5\xd6\x10\x54\x82\xa1\xa5\x10\x0e\x2d\x9f\xbd\x9d\x20\x25\x79\x80\x7a\x5f\xc7\x95\xbc\x4b\xc3\x77\x56\xe9\x95\xab\xb1\xc2\xbd\xfc\x0a\xd3\x82\x1a\xbf\xe0\x88\xf8\xbe\x4c\x07\x17\x8a\x84\x7b\x09\x6e\x4c\x5d\xb6\x76\x36\x3f\x05\x11\xbb\xf9\x2d\x6d\x3c\x47\xef\x5e\x4b\x2d\x90\xcb\x49\x02\x78\x41\xbd\x9e\x99\xbd\x56\x25\x94\xb5\x92\xf1\x1e\x02\xd9\x70\x44\x0d\x81\x85\x89\x24\xd5\x4b\x70\x97\xaf\xf4\xde\xb3\xbc\x37\x7a\xe4\x7f\xdf\xbe\x8a\x5e\x2b\xf3\x5b\xaa\xa3\x4b\x56\x78\x56\x29\xd9\xac\xb6\xc9\x9b\x7b\xc8\x60\xab\x0e\x41\x53\xe7\x6a\x56\xbe\xe8\xd8\x47\x11\x7e\x81\x71\x24\xf6\xd5\x55\x39\x34\x91\xf0\x36\x89\x32\x2b\x3e\xdf\x46\xbc\xeb\x3b\x0a\x2e\xaa\x18\xf1\xe3\x9c\x92\xc8\xe8\x6e\x6f\xb4\x58\xaf\x5a\xfe\xfd\x78\x42\x94\xbc\xc7\x23\x57\xa8\xdc\xbc\x7d\x19\x21\x33\x03\xa7\xa3\x89\x59\xfa\x2a\x94\x5c\x41\x0b\x56\xf9\xe9\xa2\x36\xa1\x0d\xbd\x2a\x9b\x9c\x83\x45\xa0\xc9\x8d\xb9\x02\xd9\x0a\xf0\xed\x1e\x0e\x39\x06\xd2\xb4\xe3\x12\x87\xe0\xcd\x28\x97\x3f\x00\x65\x5e\x15\xfe\x01\x68\xf3\x8a\xd6\xcb\xa0\x8d\xd6\x1a\x25\x0b\xd7\xc3\xa2\xa2\x13\x5c\x50\x75\xd5\x56\xa1\x26\xf8\x87\xd0\xbf\x59\xef\xda\xc9\x39\x38\x21\x30\xbc\xfe\x15\xc7\xbe\x92\x38\xc0\xa9\x4b\xbc\x7e\x49\xd5\xbf\x61\x24\x4b\x92\x5f\x30\xfc\x24\x51\xc8\x94\x89\x9c\x10\xfc\xca\xbc\x98\xa1\x8a\x6b\x2f\x37\x92\x4b\x88\x22\x98\x5a\x15\x42\xa4\xe0\x58\x68\xbb\xf6\x55\xf5\x9d\x7b\x2c\xf3\xc9\xd1\x75\x82\xa9\x42\x8f\x12\xa0\x2c\x0b\xc9\x5d\xf4\x5c\x1a\x34\x85\x53\x95\x64\xa2\x05\x3f\xda\x0b\xf3\x4d\xde\x61\xc2\x5c\x12\x0c\xce\x62\x54\x15\x12\x4c\x48\x22\x98\x13\x4a\x90\xa8\x61\xf5\x4a\x26\x50\xf3\x67\xcb\x75\x79\x29\x58\x1c\xab\xa6\x28\xd6\xeb\x0c\x38\x9d\x9a\x68\x0a\x6d\xc3\xcc\xef\x6b\x96\xc6\x09\xb6\x1a\xfa\xa8\x92\x82\x8b\xc1\x4a\x88\x51\xa7\x6b\x95\x3a\xa3\xee\x89\xe1\x57\x58\x08\x2b\xd9\xcc\xc5\x5e\x27\x48\xa6\x92\xc5\xe2\x98\x87\x3e\xe8\x05\x6f\x91\x9c\x4f\x80\x66\x6a\x78\x25\x02\x78\x94\xc0\x66\x1d\xea\x8e\xff\x7c\x42\x75\x82\xad\x57\x22\x44\xc4\x7a\x22\xd8\xbc\xf2\x2f\x96\xcf\xa3\x84\x63\x74\x9d\xa9\x26\x12\xe9\x8b\xb3\xd9\x2c\xcc\xb5\x2c\x1c\xc7\x6b\x74\x25\xc3\xc5\x29\x41\x51\x57\xe1\xcd\x7c\xc6\x5c\x13\x14\x15\x69\xb9\x9e\x11\xc7\xc9\x1a\x59\xad\xe3\xe9\x30\x15\x10\x56\xe0\xac\x0a\xc4\xa0\xe9\x5a\xa5\x01\x82\x33\x82\xaa\x4f\x91\x65\x0b\xbb\x35\x3e\x05\xa4\x98\x7a\xb5\xb1\x88\xd7\x62\x0b\x20\xaf\x98\x0a\xe6\xcf\x25\x38\xce\xd2\x0c\x51\x89\x08\xbb\x31\x5f\xc5\x30\xc3\xf5\x47\x2e\x0d\x82\x64\x49\xba\x12\x8d\xba\x6f\x54\xf9\x68\x49\x12\xc7\x2a\x59\x14\x81\xa5\xb0\x5e\x3c\x08\x71\x92\xa6\xea\x95\x06\x21\x81\x87\x23\xdd\x44\x73\xe3\x03\x09\x3f\x91\x69\x6c\x36\x92\x0d\xdd\xb2\x4d\xa8\x16\x4c\xbb\x38\xc9\x62\x64\xa5\x01\x49\x10\x42\x24\x44\xce\xc5\x4d\x51\x35\xac\x92\x69\x11\xa4\x90\x58\xc7\xe5\xe2\xa7\x09\xa2\x92\x51\x11\x54\xa9\xa5\x08\xce\x60\x2c\x55\x69\xda\x20\x68\x97\xef\x60\x00\x9a\x48\x87\x73\x24\x48\x86\xe6\xcc\x0b\xc6\x1e\x43\xd6\xf0\x6a\x6b\x2c\x32\xec\x6b\x47\x77\x2c\x94\x18\x74\xf8\x57\x12\x03\x38\x16\xc5\x5e\x49\xfd\x24\xe5\x8d\x66\xd1\x99\x2f\x72\xfc\x87\x4f\x05\xdf\x9f\x0a\x2d\xc8\xa6\xb1\x88\x2e\x48\x85\xa4\xfb\xf0\x69\x44\xf5\x54\xcd\x47\x91\x35\x7f\x22\x4c\xad\x64\x14\x6c\x23\x2c\xef\x4d\xa3\x4a\xec\x4d\x95\xf2\xa7\xdf\xe0\xcc\xb4\x4b\xc6\x7b\x9b\x4b\x70\x05\x45\x1a\x2d\x72\x6f\x2d\x52\xb4\x47\x2b\xe5\x08\x49\xb0\xea\x2e\x52\x68\x45\x72\x8c\x47\x6e\xee\xac\x90\x9c\x31\x88\x88\x43\x49\xd4\x84\x85\x89\x24\x63\xbe\x70\xc2\x05\xf7\x66\x41\xb9\x6b\x85\x29\xd4\x2a\x39\x4f\x8a\x15\x4c\x24\x3a\xaa\x26\xe7\x92\x22\x70\x97\x14\x46\x00\x0c\xbf\x24\xc9\x4b\x92\xfc\x46\x11\x2c\xe5\x92\xc2\xca\x93\xf2\x57\x95\xa2\xa9\xea\x41\x2c\x56\x91\x22\x49\xb8\xab\xd8\xf2\x04\x69\x4c\xd0\xd4\x77\x47\x95\x55\x7b\xed\x15\x3a\xe7\xa3\xaf\xe1\xac\x1b\x4f\x54\xc0\x8f\x87\x5e\x68\x66\x07\x8e\xc8\x17\x0c\x15\x10\xaa\x63\xd5\xe8\x10\xdb\xe5\xac\x7f\x6b\x72\x62\x16\x3d\x06\x0d\x32\xba\x64\xde\x29\x3e\x3b\x2e\x2d\xca\xbb\x3e\xdf\x35\x72\x5d\x56\xfd\x9b\x99\xa1\x2e\x6f\x97\x0b\xee\xca\xf3\xc8\x2a\xa4\x05\x45\xd5\x6c\x64\x0a\xa6\x13\xf3\x41\x04\xf1\x15\xc3\x33\x71\x67\x64\x43\x72\x0f\x93\x57\x4d\x87\xec\x1c\x28\x8f\x1e\xc4\xbb\x6e\x3c\xdd\x5e\x33\xc3\x1e\xd5\xef\x75\xf8\x41\xe3\xae\xd7\xba\xaa\x91\x04\x47\x91\xcc\x0b\x3d\xe8\x35\x47\xc3\xee\xf5\xe3\x6d\xed\xfa\xaa\xdb\xb8\xbb\xef\x76\x5a\x7d\x6a\x54\xe3\x9f\x1f\x1f\x26\x49\xc5\x64\x12\x21\x5c\x22\x57\x4f\xd7\xf7\x37\x8f\x0f\xdd\xc7\xfe\x73\xbb\xd5\x7d\x18\xdf\x3e\x3e\xd0\xad\xeb\x36\x47\x76\x7b\xcf\xcf\xc4\xcd\xfd\xed\x5d\xad\xcf\xdd\x70\x13\xfe\xbe\x35\x61\xba\x83\xc6\x88\x6f\x3d\x3c\xf5\x7b\xa5\x89\x90\x1e\x91\xe1\xe0\xb9\xdd\xe9\x12\x8d\x0e\xd9\xea\xdd\x53\x57\x4f\xdd\xd6\x5d\xaf\xd9\x6d\xdd\x4c\x7a\x83\x09\xd1\x7e\x26\x5f\xee\x5a\xa3\x76\xbf\x37\x69\xf0\x7d\x6e\xf4\x58\xbb\x6f\xd4\xfa\x4f\x44\xbb\x34\x11\xca\x25\xc2\xd1\x8f\x57\x83\x67\x8e\x7e\xa6\x1e\x39\xbe\xfd\xf4\x38\x24\x26\xb7\x7d\x62\xd2\xa7\xae\x26\xd7\xed\xc9\x7d\x8d\xe2\x27\x83\xdb\x7e\x8f\xb8\x6f\x3f\x50\x8f\xc3\x76\xbf\x33\xec\xdd\xde\xb6\x89\x93\x7d\x2f\x3f\x00\x23\xbe\x28\x09\x5b\x7c\xfe\x31\x79\x31\xc0\x39\xa0\x36\xa7\x1e\x8b\x2c\x70\xf7\x8c\x5d\x95\x2c\x5f\x95\x73\x5d\x47\x91\x34\x96\xef\xf7\x4e\x77\x7a\xb7\x4d\x15\x0b\x9a\x76\xae\x6b\xdf\x91\x16\x9e\xed\x8a\x8c\x81\xf8\x89\xcd\x73\xe0\x0e\x8b\x7f\x3e\xfb\x31\xc4\xe7\x4b\xf0\x99\xfe\x16\x9c\x88\xfd\x7c\x0e\x3e\x6f\x77\xaa\xdc\x47\x3a\xb4\xd5\x0f\xf4\xf9\xbf\x59\x86\x9a\xa4\x86\x27\xa8\x11\xe7\x80\xfc\xa5\xd4\x62\x67\x48\xcf\x01\xe6\x11\xb3\x6c\x77\xd9\xa9\x4f\xc3\xf5\x92\x8b\x1b\xc7\xb0\x0d\xe1\xd2\x04\xc8\x38\x81\x14\x69\xa2\x68\x8f\x2d\x0f\x79\x0e\x70\x5f\x20\xff\xa6\xa0\xcf\x97\xae\x88\x9f\x7d\x53\x10\xde\xd0\xda\xa5\xb1\xaf\x13\x2d\xcf\x15\x15\x70\x45\x11\xb5\xc0\x80\x7e\x91\x96\x03\x02\xbf\x5a\xcb\x09\x79\xca\x69\x79\x4f\xdf\x5b\x9e\x2b\x22\xe4\x8a\x61\x59\xfc\x97\x6a\xd9\x27\xf0\xab\xb5\x9c\x90\xa7\x9c\x96\xf7\x9c\xab\x7d\xae\x0a\x9c\x6c\xda\xa1\xd1\x7d\x9d\x6c\x78\x70\x34\xba\x06\xa0\x69\x58\xc7\x45\x9a\x61\x58\x89\x42\xb0\x4e\x8b\x52\x5d\xc1\x14\x8c\xa2\xa0\xa8\x10\x12\x89\x49\x24\xcb\x40\x59\x66\x6b\x35\x12\x43\x22\xa2\x19\x4a\x94\x69\x5a\xc6\xea\x90\x91\x95\x1a\xae\xb8\x4b\xb6\xba\x58\x93\x58\x51\x81\x38\xac\x4b\x34\x89\xe3\x22\x4b\x30\x18\x56\x53\xea\x98\x22\xd6\x68\x06\x4a\x18\x45\x22\x19\xa7\x08\x02\x92\x12\x51\x27\x30\x96\x95\x08\x12\x87\x0c\x81\x31\x88\x61\x30\x7f\xd6\xc1\x13\xa9\x08\x3f\x00\x65\x92\x19\x8a\x30\x2e\x25\xeb\x14\xcb\x50\x85\x4f\x03\xbf\x8e\xb3\xde\xb9\x78\xe6\xdc\xab\xaa\x4e\x7c\xce\x01\xe5\xfe\x83\x07\xff\x84\x3f\xe2\x9b\x3f\xdc\xa9\x87\xe3\x38\xae\x79\x63\xb3\xea\x85\x01\xf5\xd6\xdd\xd0\x69\x3c\x73\x0a\xdd\xac\xc9\x8f\x26\x77\xff\x05\x9b\x74\xde\x07\x8d\xb7\xa9\x7a\xd7\x59\x2d\xd4\x2b\xe7\x65\x3a\x1a\xe0\xf0\xce\x18\x3c\x2f\xc8\xf7\xc6\xa8\xa1\xbc\xe0\x57\xaf\x8f\x8f\x2b\x7d\x6d\xd9\x8a\xb9\x36\xef\xf5\x1e\xad\x20\xf6\xf9\xe5\x05\x5f\x49\x2e\x6a\xee\x49\x34\x15\x69\xea\xfe\xd5\xd9\xfc\xc3\xdd\xbb\xff\x2c\xb7\xdf\x97\xdc\xe0\xfe\xcd\xfb\x8b\x6b\xdd\xdd\xde\x7c\x40\xe6\x7e\xde\xd7\x9a\x5d\x1b\xbd\x3e\x8b\xb3\xc5\x73\xa7\x36\x9a\xdc\xf6\x15\x74\x23\x76\xe4\xb7\xf7\xd7\xfa\xb2\x8f\x73\xb6\x79\xa1\xb0\x77\xbc\x68\x74\x54\x69\x49\x35\xae\xb8\x35\xce\xd8\x73\xfb\xf1\xba\x25\xb6\xdb\x0e\x5c\xf2\xb5\xd9\x13\xdb\xe1\xc9\xd6\xcf\x27\xd5\xa3\x7f\xd7\xa3\xba\xf0\xe7\x82\xb8\xe7\xb6\x9f\xeb\xe8\x97\xcd\xe7\x85\x7b\xc2\xa9\x7b\x8e\x6b\x62\x37\x69\x8f\xff\xd5\x9f\x93\xd0\x5b\xf5\x26\xdd\x6e\x86\x77\x48\x0e\x18\xe2\x38\xc6\x7e\xc2\x90\x72\x9d\x55\x68\x92\x41\x88\x61\x65\x5c\x24\x6a\x22\x2d\xb2\x75\x85\x20\xa1\xe2\xe1\xac\xd1\x4c\x1d\x12\x94\x02\x15\x9c\xc2\x48\x28\x63\x22\x4d\x88\x0c\x49\x8a\x58\x4d\x44\xf5\xfa\x89\xe7\x99\xc8\x54\xdb\xa7\xb3\x86\x04\x85\xd5\x19\x8c\x2c\x7c\xea\x4f\xe5\x14\x5d\x27\x72\xc6\x0b\x99\x31\x5e\x7c\xf7\xef\xe9\xf7\x7a\xf0\xf2\x8a\xf7\x1c\xda\xc0\xc4\x9b\xda\x23\xa5\xaf\xfb\x1f\x93\xd5\x35\xf9\xb0\x30\xde\xbe\x7c\xb4\xb8\xbe\xdd\xc0\x6f\x89\xbb\xda\x55\x8d\x79\xd1\xe6\xbc\xdc\x5f\x3c\x34\xee\xe8\x76\xd7\xac\xb7\x7a\xaf\x34\xfd\x0e\x99\x25\xd1\xbe\xbd\xb3\xdf\xc7\x83\x56\xf7\xe3\x9a\x5d\x0f\x26\x17\x90\x33\x3c\xd4\xde\x50\x89\x18\xe4\x70\xc2\x3d\xac\x6e\xe6\xb8\xd6\xbc\x5b\x2e\xdf\x9d\xd7\x5b\x69\x7d\xff\xd3\xaa\xd7\x5a\x17\x1c\x3f\x56\x1b\xd3\xfb\x81\xb9\x64\xc8\xe5\x3b\x1c\x5c\xf7\xed\x57\xec\xe1\x1d\xbd\x36\x86\xd7\x3a\xcb\x51\xb7\xcb\x1b\x5d\xad\xe9\xef\x08\x3a\x17\x18\x3f\x9b\x5d\x5c\xbf\xb1\x6b\xbe\x39\xaf\xe9\x6d\x7f\x28\xa6\x0c\x05\xde\x4a\x33\xa7\x70\x28\x70\xdc\xd5\xdb\x2f\xb5\xdb\x5f\xf0\xf1\xcd\xa9\xda\x50\xc0\x8f\x63\xc6\x5e\xe9\x14\x08\xec\x06\xaf\xd7\x30\x2f\xf4\xc7\x01\x86\x5d\x7a\xff\x65\x9a\x2b\x81\x33\x04\x51\xf8\x94\x22\xea\x54\x9d\xa9\x11\x75\x26\xc7\x98\x0b\x4d\xf9\x5f\xf9\xb9\x7a\xba\x55\xa9\xf5\xc5\x7a\x74\x7b\x55\x6b\xea\xcd\x7a\x9b\xc0\x56\xaf\x57\x5f\x2c\x6c\x6a\x5b\xcb\xce\xf2\x27\xfe\x24\x8f\x1e\x9f\xe1\xd5\x0d\x6c\x79\xa6\xcc\xa7\x98\x72\xfa\xe7\xff\x73\x53\xc6\xa2\xa6\x5c\xb0\xba\x2a\x71\x2f\xc0\xbe\x8b\xad\x8c\xb2\xb5\xac\x90\xb3\xf8\x4a\xa2\x54\x34\xc9\x38\x99\xd8\x0f\x4d\x22\x62\x24\xf7\xc3\x42\x25\x02\xdb\xfd\xb0\xd0\x89\x40\x67\x3f\x2c\x4c\x1c\x0b\xb5\x1f\x96\x5a\x22\x1c\xd8\x0f\x0b\x9b\x88\x61\x8e\x73\x67\xc3\x51\xb2\x3f\xf9\x85\x91\xe7\x80\x2d\x9b\xf5\xca\xb8\xb9\xe0\xe0\xd1\x93\x75\x83\x57\xec\xe6\x2c\x3f\x78\xf8\xe7\xb3\x6d\x1c\x14\x8f\x9d\x83\xcf\x8a\x69\xcc\x0f\xca\x4f\xb8\x11\x68\xa5\xa4\xd1\x2f\xc8\x28\xa7\x28\x2f\x3a\x2e\x63\x37\x85\x85\x01\xbb\xe2\xe8\x32\x32\x7d\xf5\xed\x97\x15\xf6\x64\xf4\xd3\xa6\x87\x6a\xb0\x38\x7b\xf0\x0b\xb2\xd7\x59\x5a\x0b\x3c\xc8\xe6\x6f\xea\x97\x6a\x6d\xdf\x8c\xcd\xbf\x4e\x6b\xbe\xaf\xdb\xfc\x8d\xfd\x52\xad\x1d\x30\xe2\x7f\xb9\xd6\x0a\x1c\x67\xca\xd5\x08\x07\x14\x05\x57\x3a\x41\xbc\xaf\x73\xce\x2c\x55\x4f\x5d\xdc\x94\xbc\xda\xb0\x78\x79\x43\x65\x2f\x6f\x0a\x11\x91\x71\xb7\x97\x35\x91\x17\xe2\xa1\x12\xee\x73\x5f\x3c\x09\x87\xb2\x37\x3f\x4c\x1c\x4f\xd6\x32\xa7\x10\x4f\x2d\x3e\x54\xf7\xe6\x87\x8d\xe3\xc9\x5e\xea\x54\x3d\xfc\x7c\x8c\xc5\x4e\xd1\xe1\x88\x0a\xcb\x9d\xcc\x93\xce\x47\x18\x53\x91\x3d\x72\x09\x89\x22\x5b\xa3\x21\x86\x29\x0a\x83\x70\x92\x25\x21\x52\x30\x45\x26\x68\x1c\xd6\x18\x85\x20\x24\x5c\xa9\x43\x91\x80\x84\xac\x28\x92\x88\xd5\x6a\x2c\x4d\xd7\x48\x06\xca\x88\x60\xe8\x3a\xf4\x23\xfb\x83\x76\xad\x23\x19\x21\x32\x0c\x94\x33\x93\xae\x34\x86\xe7\x24\x6c\x83\xa7\xb1\x11\xed\x47\xd8\xb7\xcc\x2b\x52\xc9\xd7\xb9\xd1\x61\xc7\xd7\x5a\xf3\x02\x4d\x25\xb2\x36\x78\xb2\xdb\xb7\xb7\x3f\x1f\x1f\xd8\xe5\x83\xfa\x72\x05\x1b\x0e\xdd\xa5\xef\x38\x2f\x42\xe5\xc2\x94\xe8\x55\x22\x00\x8c\x7c\xe7\xbd\x7f\xc5\xf9\x74\x8e\x3f\x10\xf2\x94\x7e\xc0\xe7\xef\x38\xd2\xee\xa4\x6b\xdc\x5e\xbd\x8e\x9e\x6f\x5f\xea\x4b\x7e\x6a\x8c\xae\x20\x7a\x64\x27\x6a\xcb\x88\xa0\xe9\x32\x6c\x27\xf2\x15\xd6\xde\x3e\xde\x96\x1e\xfa\xfa\xc0\xa9\x2f\x5e\xd7\x6f\xd2\x70\xc4\x60\xda\x7b\xbf\xfb\xde\x63\x5b\xed\x9f\x04\x45\xdd\x0f\x58\x11\x3e\xf7\xd0\x78\x7c\xf3\xd2\xd1\x4c\x72\x24\x0e\x1b\x38\xf9\xce\x9b\x75\x67\x40\xf5\x87\xcd\xe9\xba\x71\x75\x31\x95\x9c\x29\x71\x7d\x6b\x36\xef\x9c\x5b\x6c\x34\x26\xef\xfb\xf0\x76\x72\xb5\xfc\xf1\xe3\x24\x9a\x6d\x88\xa6\x5b\xef\xd3\x64\xe3\xb6\xf0\x89\xe7\x3e\x90\xa7\xa6\x46\x44\x2d\x0e\x6c\x88\x0f\x4f\x2f\x44\x53\x7b\x7a\x84\xe6\x03\x33\x59\x2d\xc5\x47\xf2\xba\x77\x33\x5d\xe8\x24\x37\x6a\xcc\x3a\xad\x05\x2d\xae\x46\x9d\x47\x2f\x5b\xc0\xd5\xe6\x56\xa0\x8f\x69\x4e\xb8\x9d\x99\x4c\xf0\x74\xdf\x3c\x80\xfe\x17\x4d\x7c\x3f\x80\xfe\x5d\x82\x7e\xc3\x31\x48\xc3\xa6\xe8\xf7\xc6\x80\x5f\x2d\xee\x2f\x48\xa3\xdd\xfb\xf2\x13\xaf\x0d\xd7\xaa\x85\x6b\xca\x5d\xeb\x79\x7e\xff\x38\x35\x9d\xd1\x97\x31\x17\xca\x3f\x97\xb6\xf4\xf9\x03\xe5\xaf\x4c\x9f\xd2\xeb\x6f\x7b\xd2\x8f\xd8\xd2\x94\x4b\xb1\x85\x7d\x74\x71\x4c\x5b\xf8\x9d\x7d\xe1\xeb\xe2\x9f\x5f\x35\x68\xbd\xc5\xa1\x77\x41\x40\x98\xca\x2c\xf3\xaf\x3b\xc5\x78\xae\xb4\x78\x96\x8d\x55\x20\xd7\x28\xe4\x3a\xe2\xba\x58\x47\x4a\x4d\x16\x61\x1d\xd2\xb2\x48\x92\x64\x5d\xac\xb1\x8a\x0c\x59\x85\xa4\x6a\xb5\x9a\x88\x43\x85\x24\x45\x48\x31\x2c\x94\x69\x09\x93\x95\x3a\xc5\xc8\x94\x7c\xe2\xed\x9e\xe2\x87\xac\x66\xfd\x50\x3b\x6f\x0a\xa0\xb0\x7a\x0d\xcf\xdc\x95\xdb\x3c\x8d\xae\xa1\x82\xed\x82\x2e\xdb\xbe\xff\xb8\x7f\x13\x6f\x89\x36\x47\x3e\x3e\xbc\x0e\xcd\xdb\xf9\xeb\x13\x86\x29\xd7\xac\xd5\xed\xd4\xe6\x18\x3f\x5c\xde\x3c\x5e\x70\x4f\x24\xb7\x99\x01\xbc\x4f\xce\x0c\xe0\x7f\xcc\xf7\x1e\xd3\x45\x7d\x38\x7d\x5d\xdd\xc1\xc9\xa0\xce\x5c\xfd\x54\xac\x3a\xc2\x24\xc3\xec\xbd\x3c\xfd\xbc\x7a\xbc\x79\x6b\x19\xb7\xa1\x87\xe7\xb8\x3e\x6d\xde\x46\xf1\x3d\x7c\x2c\x5b\x75\xf7\x11\xdf\x68\xfe\x7c\xff\x78\xbb\xbf\xba\x37\x7a\xdc\x8d\xaa\x0c\x86\x4f\x4d\xa3\x3b\xfb\xb0\xd7\xd2\x98\xd4\x5a\x83\xc6\x3d\x8d\x4f\xdf\x64\xab\xd5\x86\x57\xbd\xc7\x25\x46\x8f\x2e\x1e\x66\x8f\xd8\xd3\xf4\xcd\xc4\x1a\x57\x03\x9e\xea\xc1\xd6\x03\x71\x3b\x97\x2c\xf2\x65\xd9\x9d\xab\x22\x35\x1e\x9a\x77\xdd\x12\x9e\x3f\x66\xd2\x59\x9e\xdf\xdf\x28\xdc\xf1\xfc\xea\xc5\x15\xd6\xc5\x6e\xae\xd7\xf6\x6c\xd9\xc3\xb5\x67\x0c\xae\x17\x06\x5e\xef\xb5\x57\x1f\xdd\xc6\xba\x4f\xdb\x57\xbc\xd4\xf0\x65\x24\xa7\xb6\xd9\xd7\x9f\x2f\x6a\x93\x6d\xfb\xbb\x54\x26\x0a\x46\xfb\x01\xf4\x7b\xe6\x7a\x3c\x3e\x80\x3e\xc7\xfd\xef\xbc\x5d\xaa\xe7\xbd\xda\x5f\x17\x7d\xfd\x25\x57\xcc\x22\x5d\x1c\xda\x17\xae\x2d\x7c\x91\x12\xf8\x2a\xe9\xe2\x9f\x29\xcb\x98\x34\xcf\x4d\x6e\x9b\xf7\x8d\x67\xfd\x27\xf6\xb0\x64\x1a\x94\x58\x93\x74\xbe\x4e\x0f\xc7\xcb\xb7\xbe\xfc\x7c\xd3\x16\xaf\x86\xc4\x74\xfc\x60\xf5\xfa\x93\x0f\xfc\xf9\xc1\x6e\x51\x37\xb7\x75\x6e\x3a\x5e\xf5\x9b\x8f\xb3\x07\x59\x5d\xe8\xdd\x1e\x21\x35\x68\x63\xfe\x85\xc7\xe0\xcf\xc6\x6f\xf6\xbc\x38\x43\x41\x1a\x63\x28\x24\x42\x86\x52\x08\x49\x16\xa1\x2c\xb2\x34\x23\x2a\x24\x45\xb1\x14\x4b\x2b\x12\x43\x30\x04\x55\x83\x32\x24\x91\x4c\xd6\x25\x59\x56\x30\x85\xa9\x63\x04\x4e\x92\x22\xe3\x7b\x5e\xe2\x30\xcf\x4b\x14\x7b\x5e\x96\xac\xe7\x78\x5e\xff\x69\x34\x5a\x3c\xd4\xf3\x36\x12\x5d\xbe\xe3\x79\xfb\x44\xe3\x82\xeb\x53\xf4\xf3\x55\x93\xb4\xdb\x0f\xad\x3e\x3e\x24\x39\xec\x0e\xbd\x0d\xd8\x9b\x21\xa3\xf7\x70\xae\x8e\x1e\x55\x79\xdd\xb1\xfd\x01\x9f\xed\x79\xb9\x11\xff\xa2\xbe\x88\xa8\xb5\x6c\x58\xe6\xed\x95\x7e\xdb\x71\xac\x0b\x8c\x7e\xb0\x6f\x9a\x57\xe6\xd4\xb0\x9c\x59\xf7\xfe\x62\xc2\x3c\x4d\x5e\x29\x7b\xf9\xb8\x9e\x59\xb5\x89\x3d\xa2\x1a\x77\x68\xd5\xbf\x63\x6e\xde\x25\xe5\xfd\xe6\x16\xc7\x1e\xb5\xab\xb7\xb7\xa5\x4e\x4d\xd9\x41\x47\x79\xed\x5c\xff\xbb\x3c\xef\xa1\x9e\xef\xd0\xd1\x7e\xb7\xec\xce\xcd\x23\x7a\x5e\xae\xf6\xdc\x65\xb9\xda\xab\x36\xe5\x07\x08\x93\x27\x93\xda\x43\x5b\x6a\xde\xaf\x98\xfb\x8b\xa5\xd6\x7e\x97\xc8\x49\x13\xa7\xe1\x0d\xd9\x51\x71\x1f\xe7\xb1\x3d\xef\xff\xc8\xf3\x71\x47\xf2\xbc\x2c\xb5\x6d\xdf\xa9\xac\x8b\x7f\xf8\xd9\xf5\xf3\xfc\x91\x9c\x49\x9c\x79\xbb\x9e\xbe\xac\xd5\xae\x39\xa8\xf7\x1f\xc4\xd1\xfd\x12\x52\xb7\xdd\xae\x31\xc2\x06\x78\x5f\xc3\x3b\x5f\xba\x52\xcb\x32\xc4\x3e\xde\x9d\x38\xdc\x6b\xdb\x1a\xbf\xf6\x55\xa8\xb7\x19\x75\x64\xcb\xad\xc5\xfd\xcb\xcd\xdd\xcd\x97\xce\xa0\xb9\x6e\x53\xeb\xab\xe9\x6f\x5e\xf3\x8a\x04\x62\x09\x59\x84\xa2\x88\x11\x94\x48\xd4\x20\x26\x91\x38\x85\x49\xb0\x86\xcb\x2c\x94\xea\xa2\x54\xc3\x59\x12\x57\xea\x0a\x0d\x49\x51\x66\xea\x48\x82\xa4\xcc\xb2\x8a\x88\x21\x89\x96\x4e\x36\x15\x83\x07\x78\xde\xa2\xb4\x07\x85\xd5\xeb\x74\x5e\x61\x8d\xff\x34\x9a\x17\x3b\xd4\xf3\x36\x13\x5d\xbe\xe3\x79\xab\x66\x3d\xb2\x3d\x6f\xf3\xc6\xd1\x70\xbb\x7b\xdd\x6d\x51\x0f\xab\xa5\x8d\xc9\xcd\xc6\x03\xaf\x30\xb6\x48\x6b\x94\xb8\xbe\x33\xaf\xa7\x8d\xc5\x17\xed\xe1\xe5\x6e\xbe\x92\x6c\x9a\x52\x7b\x0a\x31\x5f\xd9\xaf\x2b\xe6\x4e\xa6\x5f\x6e\x28\x9e\x6a\x6a\x92\xa5\x50\x0c\xcf\xcd\xae\xae\x47\x93\x81\xa5\xb3\xca\x73\xf3\xdf\xe5\x79\x0f\xf5\x7c\x87\x8e\xf6\x2e\xf6\xc6\x34\x8f\xe8\x79\x7f\x67\xb6\xe7\x57\x78\xde\x7d\x3d\x1f\x77\x24\xcf\xbb\x6f\xfc\x13\x78\xde\xb5\xb8\x90\xc5\xd1\x4a\x5d\xa1\x96\x24\x75\xe5\xf6\xfd\x52\x1b\xb6\xbf\x98\x8f\x5f\x5e\xd0\x35\xfb\x7a\xbb\x32\xb8\x77\x65\xf1\xf0\x38\xbe\xb1\x9e\xba\x08\x75\x5e\x9f\xea\x0b\x4b\x7c\x66\xd1\x6b\x1b\x3d\x8e\xd0\x55\x9f\xa3\x9f\xba\xed\x2f\xfd\x19\xd7\xb9\x1f\xbe\x69\xcd\xda\xcd\x45\x9b\xe0\x8e\xb2\xe6\xcd\xc8\x6a\xe7\xdd\x80\x57\x35\xa1\x9d\xbc\x05\x6f\xe3\xcb\xd1\x6a\x11\x5e\x04\xe0\x5d\x93\xe5\x57\x94\xb9\x22\xe5\x9d\xeb\x4a\xb9\xde\xee\x80\xed\xb1\xac\x5b\xd8\xaa\x1f\xd0\x89\xbf\xab\x3a\xf6\x4d\x58\xbc\xa1\x75\x88\x7e\x7b\xbd\x7a\xd5\x8b\xa1\x62\x38\xbd\xdb\xc5\xb8\x66\x33\x7a\x5d\xfb\x2e\xd1\xe8\xb5\xd8\xe0\x74\x7b\x39\x5c\xe6\xcb\xa6\xb7\x38\x8e\xcb\x73\x2e\xbb\xbb\x9c\x6e\xaf\xa5\x2b\x7c\x2d\xf6\xee\x2b\xa3\x8f\xac\xed\x00\x6d\xae\x04\x51\xd2\x71\x49\xfc\x27\xe7\x20\x4f\xa2\xc8\x8b\x94\xa3\x37\x95\x1c\x49\x8e\x2d\xc6\x54\x11\x12\x04\xe3\xdc\xa7\x70\x9b\x7c\xf5\x73\xe2\xfb\x91\xb8\x4e\x60\x4d\xe3\x3c\x8d\x70\xc2\x8a\x36\x77\x0b\x9e\xc7\x2e\x26\x3c\x8f\xdc\x63\x58\xf4\xea\xe7\xe4\xf7\x23\xc9\x97\xc0\x9a\x26\x5f\x1a\xe1\xc2\xde\x49\x5c\xf4\x97\x38\xd3\xb7\x55\x88\xb0\xd5\x80\x10\x55\x8d\x70\x14\xe9\xe2\x64\xd3\x84\xdb\x8b\xb1\xf0\xbd\xa3\x29\x1d\xeb\xc2\xc7\x3b\xb9\xa2\x6a\x8e\xd3\xad\x95\x05\xaf\xd4\xa9\x19\x55\x85\x05\xa5\x7b\xc7\x95\x2c\x9d\x48\x9e\xa4\x39\x6c\x95\x96\x3c\xb3\xcc\xa0\x70\x27\xff\xb8\xd2\x67\x91\xc9\x93\x3f\x97\xb5\x42\x0d\x24\x57\x4f\x89\xef\x47\x92\x2f\x81\x35\x4d\x9c\x34\xc2\x71\xee\xd3\xd6\x15\xc1\x6d\xc2\xfe\xff\x8e\xc4\xac\x8f\x2c\x8d\xc7\x08\x99\x38\x6b\xe1\x85\x5c\x79\xb7\xf0\x46\xff\x3e\x12\xa7\x11\x8c\x69\xec\x26\x09\x56\x5e\xad\xf9\x0b\xbd\xed\xd2\x42\xd0\xe1\x7c\xb3\x58\xf7\xde\x50\x51\xee\x36\xe1\xd8\xfb\x9c\x73\x91\x83\x7e\x2f\xb1\xd2\x8d\xbd\xd0\x62\x0b\x7d\x0e\x5c\xf0\x6c\xce\x67\xc6\x1c\x09\xb2\x31\x87\xaa\xbe\x07\xc3\x09\x4e\x23\xc8\xa2\x0c\x26\xde\xbe\xbc\x05\xca\x66\x4b\xd5\x15\xcd\x77\x56\xb2\xf7\x82\x61\xef\xef\xc3\x19\x4c\x45\x9b\xcd\x6a\x2a\x78\xc6\xba\x51\x5c\x7b\x13\xe1\xfe\x3c\x46\xb1\x44\x5f\x5b\x12\xcc\x93\xf1\xfe\xdd\x4c\xbc\xd9\xdc\xf8\xd3\xef\xe1\xfc\x04\x97\x48\x97\xe2\x28\x63\xca\x17\x37\xf7\x36\xec\xcd\xce\x16\x45\xc6\x5b\xbf\x93\xfc\xf8\xc0\xe7\x3b\x2f\x79\x48\x63\x2e\x72\xc1\x7d\x39\x06\x17\x86\x65\x4f\x4d\x64\xa5\xf2\x19\xbd\x2e\xbf\x14\xaf\x91\x06\x67\xe0\xb1\xcd\x0f\xf9\xd8\x95\xfb\x9d\xd1\xe6\x86\xea\xef\x3b\xac\xcf\xa0\x35\x3b\x02\xcf\xde\x2b\x00\xfa\xbd\xdc\x77\x7c\xc4\xdf\xd7\x93\x78\x7f\x40\x9a\x5a\xfd\x17\x02\x1c\x89\xc3\x2d\xb2\x72\x4a\x4d\x7f\xcd\x41\xa8\xdf\x8c\x97\x20\xe4\xaa\xda\x9f\x08\x0e\xb1\xe0\xe0\xde\xf1\x52\xfc\x27\x5e\x8b\x72\xbe\xfb\x06\x94\xa2\x90\xf0\x60\x97\x94\x81\xcf\xe5\x3f\x19\x7d\x96\xf5\x4e\x29\x28\x0f\xf4\x53\x99\x18\x4b\xb2\x99\x13\xa5\x08\xc8\xc5\xe6\xe9\xfa\xd0\xc9\x3c\x81\x2e\x6a\x02\xe1\x4d\x07\xf1\x49\x32\xe5\x45\x96\xe7\xe1\x4b\x2b\xb3\x98\xdd\x5e\x79\x7e\x20\x9b\xf1\xf7\x66\xe5\x32\x18\x5d\x69\xec\xc1\xb4\xb1\x10\x16\xc7\xe2\x3b\xc0\x15\x65\x3d\x23\x52\xdb\x4b\x92\x74\x01\xec\xd5\xf1\x04\x08\x70\x65\xf8\x87\x3d\x45\x88\xbf\x19\x6c\x57\x08\x63\xe1\x5a\xe5\xcc\xd8\x4b\x86\x80\xf9\x2d\x8e\x7d\x95\x9f\xaf\xe8\xcd\x4b\xcf\xdd\xc1\x7d\xb8\xae\xe3\xe8\xa2\x2c\x87\x87\xa9\xe3\x33\x49\x2a\x47\x51\xbd\x1e\x8b\xad\x1d\x9c\x25\xa7\xba\x14\x06\x6d\xbf\x4b\xec\x43\xba\x75\x8b\x63\x7f\x93\x2c\x32\x3f\xdb\x94\x5d\x22\xd1\xf7\xe2\x1e\xc0\xf0\x2e\xb2\xdd\x17\x00\xc6\xf9\x4c\xbc\x90\x37\x9f\x41\x2f\x7c\x3d\x0e\x7b\x1e\xaa\x52\xcc\x65\xc6\xcc\x21\xbe\xc4\xab\x7e\x0f\xe6\x2f\x81\xaf\x88\xc9\xdd\x37\x0d\x17\x72\x7a\x1c\x3d\xc6\xb0\x95\xe5\xb2\x50\x9b\xc7\xe1\xad\x14\x4f\xf9\xbc\x84\x1c\xfb\x6f\xd0\x3c\x8c\xa3\x38\xae\xd2\x3d\x1a\xbe\x91\x38\x95\xbf\x05\x54\x4d\xc1\x7b\x81\xda\x31\x38\x4c\x62\x2b\x37\x6e\x73\xde\x2d\x9b\x7c\x8d\x68\x86\x10\x47\xf0\xdb\x01\x9e\x22\x8e\x2b\xae\x8e\x5c\xac\x47\xd3\x6e\x05\xc5\x16\xea\xcd\xbf\x8e\x76\xe7\x3e\x46\x43\x17\xa0\x2c\x9b\xc8\xb2\x0e\x55\x68\x21\x81\x58\x2e\x22\x35\x71\x13\x00\x56\xe0\xfd\x70\x3b\xc8\xc3\x5d\xcc\x71\xca\x28\x8b\x23\x0c\x56\xe1\x2e\x3e\x7b\xbd\xd8\x3f\xa8\xcb\xc5\x5a\xb8\xec\x4f\xdd\xaa\x8b\xa3\x0c\xd6\x50\x2e\xca\x8d\x11\x1d\x89\xdb\x34\xd4\x85\xcb\xb7\xb2\x96\x1c\x41\x7e\x6c\x63\x88\xa1\xde\x67\xbd\x99\x8d\x6e\xbe\x30\x4c\xef\x65\xe6\xfe\xab\x6c\x8e\xaf\xe8\x24\x85\x62\xf6\x13\x0d\xca\x0b\x13\xb8\x9e\xf2\x09\xa3\x3d\xf4\x1f\xa1\x51\x28\x49\x04\xb6\xbc\x10\x0b\x13\x7d\xa8\x86\x63\xfd\x16\x69\xd2\x88\x15\x8a\x95\xd6\xa8\xbc\x7c\x61\x42\xea\x97\xc9\xb4\x79\x9f\x6a\x91\x1c\x99\x19\xdd\x38\xea\xed\x45\x08\xbf\x62\x68\x27\xb1\xa7\x06\xc0\x55\x07\x78\x1c\x69\x3c\x84\x3a\xd2\x08\xcf\x23\x51\x46\x86\x82\xb8\x2e\x97\xd8\xf1\xa6\xaf\x5d\xc4\xa5\x78\x2f\x9e\xc4\xa2\xc1\xf6\xaf\x30\x9b\x5d\xfc\x7b\x87\xfa\xc1\x66\xab\x1b\x58\x46\x5e\xdc\xba\xb7\x82\xd3\xd1\xb9\xdc\x05\x7b\xc8\xf1\x65\x78\x04\x26\x87\xb3\xb4\xd7\x6f\x1e\x81\xc3\xd4\xb7\x7a\x66\x70\x9a\x06\x9b\xc3\xb1\xff\xc6\xdd\x23\xf0\xe8\x23\xca\xe2\x6a\xf3\x62\xdf\x02\x56\x8e\xd9\xaf\xf1\x17\x00\xe7\x30\x96\xdd\xb3\x61\x9d\xdd\x11\x36\xf6\x76\x51\xc5\xf6\xb6\xc3\xea\xc2\x8c\xed\xed\x94\x42\x02\x28\xa3\xcd\xb2\x36\xcc\xb7\x0b\xa2\x61\xbc\xed\xcd\x62\x0e\xce\xc2\x05\xf3\xe9\xa9\x8c\x6c\xa8\x6a\x16\xf8\xfa\xe7\x9f\xe0\xc4\x32\x34\x39\x52\x5a\x75\x72\x79\x69\xa3\x95\x7d\x76\x76\x0e\xb2\x01\x25\x43\x2e\x07\xe8\x6f\x65\x64\x83\x8a\x86\x33\x9d\xd9\xa5\xc8\xc7\x40\xf3\x19\x88\x81\x26\x58\x08\xb7\xdb\x3c\x97\x0b\x7e\x00\x92\xcc\xab\xfc\x88\xd8\xc0\x21\x13\x5d\x26\x46\xb7\xb3\xa2\x85\x26\xe5\x6d\x2a\x86\xf0\xc0\x0d\xab\x54\x6c\xf9\xac\xe5\x6d\x54\x25\xd0\x79\x05\x7b\x5e\x01\xdf\x71\xd9\x4c\xe2\x2d\xc1\x70\xb4\x16\x70\xb7\xf8\xb3\x74\xf9\xad\x2a\x0b\x4a\xa4\x0a\xa8\x75\xfb\x7b\x8a\x70\x03\xb2\xa0\xd5\x1f\xf2\x9d\xeb\xde\xa6\x30\x0c\x0c\xf9\x16\x3f\xe4\x7b\x0d\x7e\x94\x28\x88\xf0\x9e\xf6\x7b\x60\x32\x68\xba\x6a\x1c\xf2\xa3\xf1\xb0\xd3\x18\xbb\x3f\x35\xf9\x2e\x3f\xe6\x41\x83\x1b\x35\xb8\x26\x9f\x53\x5d\x27\x23\x2b\xf1\x55\x48\x64\xa8\x8f\xa7\x8c\x38\x9d\x82\xd2\xb9\x2c\x4e\xe2\xfa\x49\x66\xd3\x53\x95\x15\xb8\xf6\x82\x3a\xc3\x4c\x4d\x04\x19\xbe\xff\xb9\x1e\xa2\x7c\xa4\x69\x21\x4c\x9e\xe6\x1b\x4c\x35\x0d\xec\xe6\xda\xff\x87\x6a\xc8\x60\x26\xae\x8b\x94\xdd\x81\xe3\x1a\x45\x32\xf3\xfb\x6f\x50\x48\xb6\x69\xec\xa4\xd6\x0b\xad\xc3\xd7\xc4\x78\x86\x80\x62\x68\x9a\xb1\x54\xf5\x29\x68\x36\xbb\x40\xb5\x80\x08\x2d\x55\x82\x9a\xb6\x06\x50\x5f\x83\x39\xd4\xd5\x85\xa3\x05\x01\x8f\x3d\x83\x36\x98\xc1\xc5\x02\xe9\xc0\x36\x80\x3d\x43\xc0\x7f\x51\x34\xb0\x54\x37\xb8\xde\x14\xb4\x03\xaa\xf6\x0d\x74\x14\xb0\x36\x1c\xa0\x23\x24\xbb\xd0\xaa\x2e\x69\x8e\x8c\x5c\xc2\x50\x07\xce\x42\x86\x36\x02\x86\x12\x62\x50\x0c\x13\xd8\x33\xd5\x02\x96\x84\x74\x68\xaa\x86\x57\x9c\x82\x74\xd9\x23\x73\xe2\x2c\x4e\xc0\xc2\x30\x3d\xe4\x8a\x69\xcc\x81\x8e\x96\xc8\xb2\x23\x24\xa1\x0d\x5c\xe8\x19\x32\xd1\x39\x30\xec\x19\x32\x97\xaa\x85\xce\x81\x8d\x2c\xdb\x72\xa9\x2e\x55\x4d\x03\xa6\xa3\x03\x55\xb7\x0d\xb0\x30\x6c\xa4\xdb\x2a\xd4\x00\x32\x4d\xc3\xb4\xc0\x72\xe6\x4a\xe5\xfe\x23\x8b\x11\xb4\xce\xe2\x42\x36\x96\xba\x05\xa0\x89\xbc\xd6\xd0\xb1\x8d\x39\xb4\x03\x25\x89\x6b\x8f\x3f\x8f\xc8\x37\x97\x4a\xac\xcb\x37\x69\x59\xb7\x8f\x83\xd7\xf1\x81\x31\xff\x34\xfe\x9e\x51\x4b\xe8\xae\xa4\x03\xb0\xdd\x02\xc2\xab\xf1\x90\xe7\x4f\x83\xe7\x6e\x37\xa6\x91\xf2\x0b\x37\xcb\xd2\xf3\xca\x40\xd3\x89\x46\x2b\x40\x73\x29\x47\x67\xec\x02\xba\x89\xf9\x3f\x42\x75\x77\xda\xcf\xa5\x19\x44\x17\x05\xe4\x22\xe1\xc9\x96\x52\x2c\x30\xc9\x25\x52\xa2\x2c\xbe\x39\xec\x0f\xb6\x6f\xeb\xcf\x68\x9f\x5b\x58\xbe\x83\xc1\xfb\x21\xe8\xd3\xc8\xea\x45\x82\x96\x04\x65\x14\x02\xe4\x16\x53\xc5\x81\x0a\x93\x10\x39\xd0\xf1\xfc\x75\x0c\x30\x5e\xa1\x5a\x28\xb9\xdf\x59\xa1\xc7\xf6\xde\xdf\x08\x3e\xa0\x29\xcd\xa0\x79\xca\xd4\xcf\x82\xe3\x8b\x2e\x4c\xa4\x4c\x31\x03\xee\x7b\x7e\x37\x05\x76\x61\x38\xa6\xb4\x1f\xa6\x30\xe8\xf2\x38\xf6\x77\x7d\x32\xdb\xbb\xce\x14\xcc\xa7\x6a\xe8\xf8\xea\x20\x6e\x83\x9d\x96\x57\xfd\xc7\x3f\x75\x46\xe3\x91\xbf\x71\x06\xa7\x53\x6f\xf3\xcc\xb2\xe1\x7c\xe1\xbd\x8e\x71\x77\xff\x4c\x60\x30\x0c\xc3\xc2\x15\xb0\xa9\xea\xa7\x9b\x16\xbe\x03\x8f\xd0\xa4\xb1\x90\xa4\x2f\x46\xe2\x9d\x8b\xe0\xd4\x33\x34\x55\x06\x6e\xfc\xb4\xa9\x45\x3c\x07\x5f\xbf\x82\x19\x5a\x7d\x45\xba\xdb\x83\x32\x18\x18\x86\xd6\x69\x7a\xb0\x5e\x64\x65\xcd\xa1\x1b\xae\x47\x5a\x78\xcf\x14\x84\x5c\x0f\x8a\xa6\xc8\x4c\x3c\xf1\xc6\xb0\x3b\x84\xfd\x49\x0b\x88\xea\x34\xda\x1c\x34\xda\x7c\xe3\x16\x9c\x26\xc1\xfe\x04\xd8\x99\x8f\xc0\x9a\x41\x33\xab\x71\x93\x6f\x71\x93\xee\x18\x60\x3e\x9a\xd3\x28\xec\x9f\x3f\x36\x28\x7c\xab\x34\x91\x85\xcc\x0f\x64\x81\x57\xcb\xd0\xc5\x04\x9b\xa9\x09\x9e\x74\x89\x64\xa4\x21\x1b\xc9\x40\x34\x0c\x0d\x41\x7d\x97\x1b\xef\xe5\x69\x3e\x6c\xf2\xb0\xc7\x27\xb7\x9f\x62\xa6\x90\xe8\x17\x2f\x8e\x8c\xb3\xdb\xef\xed\x74\x9e\x6f\x01\x53\x55\x3f\x4d\x13\x4d\x58\x40\x7b\x26\x18\x0b\xeb\xec\x7b\x92\xd6\x07\x4a\xbe\x7c\x33\x1b\xbd\xe7\x06\xc1\x69\x20\xee\x79\xaa\x8a\x22\xe2\x6c\xee\xe9\xdc\xb8\x89\x84\x64\xfe\x15\x9b\x9e\x5a\x46\x63\x6e\x38\x06\x8f\x9d\x71\x1b\xe0\xde\x0f\x9d\x5e\x63\xc8\xdf\xf1\xbd\x31\xb8\x7a\x0e\x7e\xea\xf5\xc1\x5d\xa7\xe7\x9d\x1d\xde\x7c\xe7\x9e\xb6\xdf\x1b\x5c\xa3\xcd\x03\x7c\xcb\x40\x7c\xb8\x66\xda\x7b\x96\x0d\xe9\x68\x15\xbf\x2b\x34\x9d\xff\x93\xcb\x4b\x13\x4d\x25\x0d\x5a\x56\x60\x5d\x71\x38\x21\x39\xa4\xa2\x5d\x9e\xb7\x2f\x91\xa0\xb6\xbb\x83\x97\xda\x49\xd1\x6c\xed\x5e\x44\x76\xb9\x2f\x4b\x73\xa7\xe5\x59\x56\x5f\x6c\xe7\xca\xf4\x5e\x49\x2b\x58\x48\xf6\xd3\x79\x0c\x72\x97\xeb\x04\x78\x49\xad\x67\x72\xe6\xeb\xdf\x4a\xaf\x32\xcc\x55\x4b\xaa\x30\xe7\xd9\x9c\x27\x07\x69\x05\x06\x63\x24\x8e\xc3\x69\x66\x1f\x46\xd7\x2b\xf9\xbd\x98\xd8\xe2\xf9\x2d\xfd\x98\xc3\x5d\x4a\x4f\xe6\xc9\x52\xa2\xb6\x70\xff\xde\x2c\x60\x33\x7b\x73\xec\x40\x8e\x8b\x56\xe7\xe9\x2e\x2c\x7f\x9d\x9e\xea\x38\xb2\x56\xec\xa9\xbe\x22\xb2\x6e\x8c\xd7\xc4\xed\x3c\x49\x54\xa8\x65\xae\x2b\xdd\xa8\xdd\x6b\x1b\x16\xbc\xf9\xd6\x96\xf1\xf1\x91\x24\x32\x49\x7e\xfb\xb8\xb5\xe6\xb6\xdf\xcd\x3b\x54\x41\xd1\x6c\xfa\x0c\x64\x0d\x84\xc2\xd6\x1b\xd5\xec\x8b\x20\xd1\x30\x58\xc9\x25\x97\x29\xb1\x92\xd2\xdc\x39\x23\x56\xea\xe5\xf7\x7e\x7a\xa3\xe4\x50\x49\x56\x5b\x56\xa5\x92\xd9\x2e\x5c\x1b\x6f\xc2\x77\x1a\x8f\x5a\x58\xa7\x15\x2e\xc4\x23\x9b\x4c\x99\x00\xd1\x13\x5c\x49\xb4\x44\x9e\x5d\xba\xba\xde\xbe\x2c\x7c\xbb\x90\x0e\xd7\x1f\x78\xb0\x86\x8d\xc0\xb8\x8b\xe0\xef\x9f\x82\x2c\x6f\x02\xdd\x88\x1f\x47\xd1\xfd\x00\x44\xb0\x03\x92\xd1\x43\x91\x03\x47\xa0\x3f\xcc\x31\x9b\xd8\xc9\xa4\xd4\x0e\x8a\x90\xcd\xef\x91\x2d\x60\x89\x23\x1b\x71\x55\x52\xe9\x89\x0c\x3f\x88\x0b\xca\x31\x12\xcb\xf4\xef\x25\x5a\xb8\xf1\x52\x30\x30\x7c\x92\x50\x7e\x75\x2c\x1b\xa8\x36\xf8\x0f\xfa\x40\x26\x80\x53\xa8\xea\xff\xf9\x96\x9e\x45\x89\x5d\x0c\xe2\x01\x04\x31\xba\xff\x00\x8c\x9f\x07\x7c\xe0\x39\x13\xe2\xd0\x89\x59\x75\xfb\x52\xf5\xed\xeb\xcf\x83\x69\xb4\xf8\x83\x74\x28\x6a\x41\x00\xb2\xed\x54\x19\x29\xd0\xd1\xec\x68\xf4\x51\xfc\x59\xce\x54\x1b\x69\xaa\x65\x87\x41\xec\x5f\x7f\x97\x73\x5c\x91\x4f\x2c\x2e\xc8\x9b\xbf\xa3\xf9\x8b\x3d\x04\x3f\x9a\xd8\x87\x0b\x5d\x2c\xf2\xd7\xaf\x40\xd5\x2d\x64\xda\x5e\x26\x30\x64\x52\x56\x2d\x5f\x06\xcb\x86\x36\xf2\xd2\x9b\x08\x4a\x33\x60\x39\x0b\xaf\x94\x4d\x06\xbe\x5e\x80\x3a\x5f\x68\x68\x8e\x74\xdb\xb3\x9f\xd8\xed\x4a\xa9\xa6\x13\x5e\xb1\xe4\x6b\x01\x9c\xfc\xf3\xdf\x93\x73\x90\xbc\x68\x2f\x45\xf3\x99\xed\xe2\x7d\x66\xaf\x2c\x47\x74\xa3\x4c\x47\xb3\xc3\xee\xda\x39\xd2\xe8\x7f\x36\xc9\x10\xea\x6c\xdb\x49\xfe\xca\xcd\xd7\x6d\xc6\x81\xc8\x48\xbb\x20\x71\xb0\x0a\x08\xc6\x55\xef\x0e\x2f\x2f\x4b\x61\x21\x53\x85\x9a\xfa\x13\xc9\xa1\x6f\xf9\x36\xde\x22\xf5\x53\x07\x8e\x38\x57\x6d\xdb\xaf\xde\x8c\xa0\x08\x93\x26\xbb\x41\x60\xaf\xff\x78\xea\x07\xe9\x51\xc5\xc5\xc4\xff\x14\xea\xcc\x23\x71\x84\x3b\xb9\xfd\xe8\x76\x63\x7b\x27\xff\x80\xcf\xe3\xd5\xd0\x23\xf6\xf9\x12\x7c\xde\x5c\x2d\x56\xe2\x8e\xbc\xcf\xe0\xbf\x01\x3e\xff\x22\x42\x8c\xf9\x8a\x91\x00\x67\x2f\x09\xf6\x92\xaa\x7d\xc3\x48\x82\xaa\x33\x5f\x30\xff\xcd\xfa\x7e\xbe\x7f\xe0\x1f\x85\x1d\xdd\x77\x81\x0c\x6d\xe8\xce\x1e\x40\x76\xe6\x0b\x20\x19\xae\x0d\xda\xc8\x85\xfb\x7f\x01\x00\x00\xff\xff\x12\x6c\x66\xeb\x69\xec\x00\x00") func baseHorizonSqlBytes() ([]byte, error) { return bindataRead( @@ -166,7 +166,7 @@ func baseHorizonSql() (*asset, error) { } info := bindataFileInfo{name: "base-horizon.sql", size: 0, mode: os.FileMode(0), modTime: time.Unix(0, 0)} - a := &asset{bytes: bytes, info: info, digest: [32]uint8{0xd5, 0x4b, 0xa3, 0x87, 0x91, 0x5e, 0x2f, 0xdc, 0xfd, 0x2a, 0x13, 0xd1, 0xe6, 0x8b, 0x59, 0x5e, 0x35, 0x44, 0x6d, 0x7a, 0xd9, 0x9d, 0xbc, 0xe3, 0x34, 0x6f, 0x3b, 0xb4, 0x56, 0xbe, 0x39, 0x7}} + a := &asset{bytes: bytes, info: info, digest: [32]uint8{0x91, 0x42, 0xc3, 0x70, 0x8, 0x54, 0x34, 0xef, 0x3b, 0x14, 0x5b, 0x48, 0xe8, 0xc9, 0x97, 0x1a, 0x93, 0xed, 0xe9, 0x81, 0x53, 0x5f, 0x1b, 0x3, 0xaa, 0x3e, 0x58, 0xde, 0x59, 0x9, 0xd1, 0x82}} return a, nil } @@ -190,7 +190,7 @@ func failed_transactionsCoreSql() (*asset, error) { return a, nil } -var _failed_transactionsHorizonSql = []byte("\x1f\x8b\x08\x00\x00\x00\x00\x00\x00\xff\xec\x7d\xf9\x8f\xa2\xd8\xf6\xf8\xef\xf3\x57\x90\xce\x4b\xaa\x3b\x55\xdd\xb2\x2f\x3d\x9f\x7e\x09\x2a\x2e\xa5\xe2\xbe\x4e\x26\xe6\x02\x17\x44\x11\x2c\xc0\x52\xeb\xe5\xfd\xef\xdf\xb0\xa8\x88\xa2\xb8\x74\xcf\xcc\xcb\x97\x74\x3a\xa5\x9c\x7b\xb6\x7b\x96\x7b\xcf\x3d\xe0\xd7\xaf\xbf\x7d\xfd\x8a\x34\x2c\xc7\xd5\x6c\xd8\x6e\x56\x11\x05\xb8\x40\x02\x0e\x44\x94\xe5\x7c\xf1\xdb\xd7\xaf\xbf\x79\xf7\xf3\xcb\xf9\x02\x2a\x88\x6a\x5b\xf3\x3d\xc0\x3b\xb4\x1d\xdd\x32\x11\xee\x1b\xfd\x0d\x8b\x40\x49\x1b\x64\xa1\x8d\xbd\xe1\x31\x90\xdf\xda\x42\x07\x71\x5c\xe0\xc2\x39\x34\xdd\xb1\xab\xcf\xa1\xb5\x74\x91\x1f\x08\xfa\xbb\x7f\xcb\xb0\xe4\xd9\xf1\xb7\xb2\xa1\x7b\xd0\xd0\x94\x2d\x45\x37\x35\xe4\x07\xf2\xd4\xed\x14\xd8\xa7\xdf\xb7\xe8\x4c\x05\xd8\xca\x58\xb6\x4c\xd5\xb2\xe7\xba\xa9\x8d\x1d\xd7\xd6\x4d\xcd\x41\x7e\x20\x96\x19\xe2\x98\x40\x79\x36\x56\x97\xa6\xec\xea\x96\x39\x96\x2c\x45\x87\xde\x7d\x15\x18\x0e\x3c\x20\x33\xd7\xcd\xf1\x1c\x3a\x0e\xd0\x7c\x80\x15\xb0\x4d\xdd\xd4\x7e\x0f\x79\x87\xc0\x96\x27\xe3\x05\x70\x27\xc8\x0f\x64\xb1\x94\x0c\x5d\x7e\xf1\x84\x95\x81\x0b\x0c\xcb\x03\xe3\xab\x1d\xa1\x85\x74\xf8\x6c\x55\x40\xca\x05\x44\x18\x94\xdb\x9d\x36\x52\x17\xab\xc3\x10\xfe\xdb\x44\x77\x5c\xcb\xde\x8c\x5d\x1b\x28\xd0\x41\xf2\xad\x7a\x03\xc9\xd5\xc5\x76\xa7\xc5\x97\xc5\x4e\x64\xd0\x21\xe0\x58\xb6\x96\xa6\x0b\xed\x31\x70\x1c\xe8\x8e\x75\x65\xac\xce\xe0\xe6\xf7\x5f\x41\x50\xf6\xff\xfa\x15\x24\x3d\xbb\xfa\x75\x02\x06\xd4\xae\x97\x2e\x60\xd0\x33\xe4\x73\xc4\x22\x50\x7b\xe4\x3e\x78\x59\xcc\x0b\x83\x08\x64\x88\xd6\xe7\x6a\x0c\x55\x15\xca\xae\x33\x96\x36\x63\xcb\x56\xa0\x3d\x96\x2c\x6b\x76\x7e\xa0\x6e\x2a\x70\x3d\x8e\x08\x67\x3a\xc0\x37\x74\x67\x6c\x99\x63\x5d\xb9\x66\xb4\xb5\x80\x36\xd8\x8d\x75\x37\x0b\x78\xc7\xe8\x3d\x27\x77\x71\x71\xdd\x58\x03\x2a\x1a\xb4\xfd\x81\x0e\x7c\x5b\x42\x53\xbe\x4a\x84\xc8\xf0\x85\x0d\xdf\x75\x6b\xe9\x84\xdf\x8d\x27\xc0\x99\xdc\x88\xea\x7e\x0c\xfa\x7c\x61\xd9\x9e\x3b\x86\x31\xf5\x56\x34\xb7\xea\x52\x36\x2c\x07\x2a\x63\xe0\x5e\x33\x7e\x6b\xcc\x37\x98\x52\xe8\x97\x37\x30\x1d\x1d\x09\x14\xc5\x86\x8e\x73\x7e\xf8\xc4\xb5\x15\x3f\xef\x8c\x0d\xcb\x9a\x2d\x17\x29\xa0\x17\x97\x58\x0a\xa0\x80\x6e\x5f\x89\x78\x1b\x74\x53\x0f\xf0\xe2\x84\xaa\x42\x3b\x1d\xe8\x16\xfd\x0d\x43\x42\xb5\xa6\x1b\xe4\x87\xd6\x2b\x88\x44\x43\xf1\xa5\x11\x0b\x6f\xc0\xc4\xbd\x38\x03\xce\x41\x00\x92\x36\x17\xcd\x68\xb2\xf3\xf4\x34\xc0\x56\xc0\x87\x75\x11\x50\x77\xdc\xb1\xbb\x1e\x2f\x2e\xa3\xf4\x20\xad\x45\x5a\x48\x98\x16\x6c\x9b\x4a\xce\x03\x4b\x5b\x77\xbf\x08\x76\x39\x8a\x49\x9b\x74\x93\x19\xe4\x48\x4f\xdb\x8e\xb3\xbc\x44\x79\x07\x2c\x5b\x0a\xbc\x72\x5d\xb0\x33\x83\x05\xb0\x5d\x5d\xd6\x17\xc0\x3c\x9b\xbc\x2f\x0d\x1d\x2f\xae\x5c\x9b\xec\x32\xda\xb5\x1c\x9c\x1e\x78\x35\x7d\x5f\x79\x69\xe8\x05\x80\x3f\x1d\x7f\x30\x99\xde\x4c\x86\x7f\x7a\xf9\x61\xbb\xf4\xf3\x8d\x61\x9c\x92\x03\xcd\xb2\x17\xe3\xb9\xae\x85\x0b\x86\x33\x2c\xc4\x20\x53\xcb\x78\xfd\x7a\xef\x1c\xe6\xb4\xc6\x19\x8c\xce\xd5\xab\xdd\x9a\x88\xe8\x4a\x40\x39\x2f\x14\xf8\x6e\xb5\x93\x12\x77\x82\xd1\x3d\x00\x73\x38\xdd\xe7\x31\xf9\x9f\xd2\x8b\xbf\xcd\xd2\x6d\xa1\xd9\x15\xc4\xdc\x0d\x3a\xf3\xd6\xd9\x0e\x7c\xbb\x9a\xf2\x01\x92\xd4\xa3\x15\x98\x12\x76\xbf\x9a\x4d\x2d\x61\x82\xd7\x5f\x23\xdf\x69\x14\xe9\xc6\x86\xeb\xbe\x74\xc0\xe1\x22\x2f\xb5\x6c\x61\x04\xb8\x46\x96\x60\x48\x4a\xd8\x70\xf9\x97\x9e\x9f\xed\x7a\x31\x0d\x47\xb1\x18\x72\x1e\x38\x12\x12\x42\x40\xbe\x58\x6c\x09\x45\xbe\x73\x02\x78\xae\x7b\x3b\x0e\x5d\x86\x9f\xcd\xe5\x1c\xda\xba\xfc\xc7\x9f\x5f\x52\x8c\x02\xeb\x1b\x46\x19\xc0\x71\x3f\x03\x73\x03\x0d\xbf\x14\x93\x62\x84\xaa\xdb\x27\x87\x14\xba\x62\xae\x53\xae\x8b\x67\xe4\x19\x03\x4d\xdb\x73\xf7\x82\x1c\x31\x7a\x06\xc7\x56\xba\x3b\x70\x78\xb2\xfa\xc3\xf7\xcc\xbf\x20\xd7\x08\xe2\x8b\x9e\x02\x83\x30\xe8\x08\x62\x3b\x86\xc2\x58\x68\xce\x9b\xb1\xb5\xc5\x5c\x49\xa8\xf1\x47\x14\x7e\xff\x2d\xa8\xc2\x89\x60\x0e\xbf\x6f\xbf\x43\x3a\x9b\x05\xfc\x1e\x0e\xf9\x1d\x69\xcb\x13\x38\x07\xdf\x91\xaf\xbf\x23\xf5\x95\x09\xed\xef\xc8\x57\xbf\x38\x97\x6b\x09\xde\x7c\x85\x98\xb7\xf8\x7e\x3b\xc0\x78\x78\x33\x44\x9c\xab\xd7\x6a\x82\xd8\x39\x83\x39\x00\x40\xea\xe2\x21\x02\xa4\xdc\x46\x9e\xb6\x65\xb7\xed\x77\x8e\x8f\xe4\x29\x4e\x79\x2b\x7e\x48\x73\xa7\xa1\x8b\xf2\x1c\xe8\x52\xac\x77\x62\xfa\x44\xfa\xe5\x4e\x69\xc7\x56\xb4\xfe\x76\x40\x7e\x8f\x25\xc6\xc8\x35\xc2\x1f\x21\xf1\x15\xd0\xa8\x66\x16\x5a\xbb\x59\x45\x16\xb6\x25\x43\x65\x69\x03\x03\x31\x80\xa9\x2d\x81\x06\x7d\x35\xa4\xac\x17\x46\xd9\xbd\x6c\x68\x21\xfb\x5b\x5b\xdd\xf3\xbf\x9d\xdb\x53\xba\xdc\x59\xf6\x45\xfc\x48\x4b\xe8\x74\x5b\x62\x3b\xf2\xdd\x6f\x08\x82\x20\x55\x5e\x2c\x76\xf9\xa2\x80\xf8\xd2\xd7\x6a\xdd\x20\xde\xb5\x3b\xad\x72\xae\xe3\x43\xf0\x6d\xe4\x5f\xe3\x7f\x21\x6d\xa1\x2a\xe4\x3a\xc8\xbf\x30\xef\x53\x7c\x36\x2e\x3a\xe2\x7d\xd2\x5d\x42\xff\x30\xe1\xf0\x53\xc2\xa5\x89\x54\xf7\xc9\x97\x82\xc2\x4e\xc4\xdd\x57\x37\x49\xf8\xf9\x37\x04\xc9\xf1\x6d\x01\xe9\x97\x04\x11\xf9\x17\xf6\x07\xf6\x67\xe6\x5f\xd8\x1f\xf8\x9f\xff\xfe\x17\xee\xff\x8d\xff\x81\xff\x89\x74\x82\x9b\x88\x50\x6d\x0b\x9e\x52\x04\x31\xff\xe5\xa4\x66\x52\xe4\x81\x3b\x35\x73\x99\xc2\xcf\xd6\xcc\xff\xdd\xa2\x99\xe3\x9c\x1a\xea\x61\x97\x87\xd3\x29\x62\x9f\xb6\x8f\x30\xfa\x1c\x23\x48\xdb\xd3\x15\xf2\x63\x1f\x01\x5e\x82\xaf\x3b\xc3\x86\x80\xfc\x88\x7a\xc4\x97\x53\x5e\xfb\x50\x1e\xe3\x08\x63\x2c\x6e\xdd\x38\x3d\x87\x27\x97\x40\xf7\x72\x79\x0a\x69\x8c\xd3\x03\x87\x3c\x64\x77\x6f\x65\xc7\xdc\x9e\x5a\xe6\xdd\xcd\xed\x09\xa4\x71\x6e\xa3\x4e\x72\x96\x5b\x2f\x73\x29\x50\x05\x4b\xc3\x1d\xbb\x40\x32\xa0\xb3\x00\x32\x44\x7e\x20\x4f\x4f\xbf\x1f\xde\x5d\xe9\xee\x64\x6c\xe9\x4a\xe4\x28\xed\x40\xd6\xe8\xfa\x37\x14\xd1\x77\xb0\x74\xe2\x05\xbe\x18\xdd\x7c\x07\x12\xe9\x0a\x22\xe9\x9a\x6e\xba\xfe\xc2\x40\xec\x56\xab\x81\x38\x60\xee\x2d\xe3\x11\x79\x02\x6c\x20\xbb\xd0\x46\xde\x81\xbd\xd1\x4d\x2d\x06\x66\x2e\xe7\xbb\x25\x3f\xa2\x9b\x2e\xd4\xa0\x1d\x03\x51\x0d\xa0\x39\x88\x33\x07\x86\x71\x4c\xc6\xb5\xe6\xc6\x31\x91\xcf\x38\x45\x7d\xd9\x41\x1e\x4f\x7b\x7c\xdf\x70\xab\x3a\xe2\xd5\x8e\x9d\x4a\x5c\xb8\x3e\x52\xc8\x62\x61\xe8\x7e\xcd\x1e\x71\xf5\x39\x74\x5c\x30\x5f\x20\xde\x9c\xf9\x1f\x91\x0f\xcb\x84\xc7\x8c\x26\xed\x8a\xb6\xeb\xd1\x70\x3b\x95\x8e\xe7\xdd\xe6\x2b\x01\x6b\x68\x86\x7c\xab\x13\xac\xe8\x30\xff\x8b\xb2\x98\x6b\x09\xfe\xf2\x2b\x3b\x0c\xbf\x12\xeb\x48\xad\x2c\xf6\xf8\x6a\x57\xd8\x7d\xe6\x07\xfb\xcf\x39\x3e\x57\x12\x10\xec\x92\x30\x37\xab\x3d\x8e\xe8\xc8\x14\xc3\xa2\x07\x62\xc2\xb5\xfb\x0e\x8c\xcf\x4f\x09\x12\x3f\x7d\xff\x6e\x43\x4d\x36\x80\xe3\x7c\x89\x4f\x57\x70\x56\x71\xc2\xb6\x68\xf2\xcb\x99\x89\x0a\xf6\xc6\x77\x4b\x16\x54\x74\x76\x72\x9d\xf6\x8c\x7d\xad\xee\x34\x9b\x27\xc1\x65\x4b\x39\x05\x8e\xe1\xa7\xc1\x83\xf2\xdf\x89\x01\x14\x7d\xce\xc3\x4e\x97\x17\x1e\x64\xb6\x51\x9c\xbf\xcc\x68\xcf\x09\x82\xd4\xfb\xa2\x90\x47\xb2\xc3\x0b\x12\x05\x15\xba\xf3\x02\xed\x70\xc5\x6e\x7f\xd3\x95\x24\xde\xb6\x35\x9f\x7b\xad\x2e\xc4\x13\x9a\x5d\xcc\x67\xc6\x49\x91\xfe\xb8\xc4\x95\x04\xf9\xc9\x3f\xf8\xf8\x94\x60\xcd\xbe\x1d\x9f\xbe\xa5\x40\x17\xe8\x86\x83\x4c\x1d\xcb\x94\x92\x8d\x6d\x5b\x28\xbb\x57\x0f\x21\x9e\x50\x0f\xdb\x73\xeb\x04\xde\x22\x87\xc9\xa9\xbc\xf0\xd4\x39\xf6\xe9\x81\xa1\x5a\x22\x95\x51\x7f\x22\x76\x7c\x6c\xa3\x1c\x1a\xa3\xb0\x9f\x88\x74\xf0\xbb\xc3\xe4\x58\x62\xb2\x96\xee\x3e\x37\xc5\xc7\xd8\x10\xb8\x17\x07\x05\xb0\xcb\x85\x92\x1a\x76\x67\x3a\xe1\xc7\xd8\x39\xfb\x91\x2c\xd8\xd1\x7a\xc0\x05\xc6\x58\xb6\x74\xd3\x39\x6d\x83\x2a\x84\xe3\x85\x65\x19\xa7\xef\xfa\x27\x9f\x2a\x4c\x9a\x6b\xff\xb6\x0d\x1d\x68\xbf\x27\x81\x78\xeb\x50\x77\x3d\xf6\x97\x49\xfa\x47\x12\xd4\xc2\xb6\x5c\x4b\xb6\x8c\x44\xb9\xe2\x73\xb4\x35\x16\x08\x14\x68\xfb\xcb\x8b\xe0\x7b\x67\x29\xcb\xd0\x71\xd4\xa5\x31\x4e\x34\x94\x50\x70\xa0\x1b\x50\xb9\x04\x15\xb2\x9e\x60\x42\xc9\xae\x97\x50\xdf\xbe\xd7\x13\x13\xce\x4c\x2e\xe4\xc5\xf4\x11\xe9\x72\x8c\xbb\x56\xe4\xc7\xa6\xba\xb3\x34\x7e\x55\xea\xbb\x4a\xd0\x3b\x53\xe1\x59\x5a\xc7\xa9\xf1\x34\xf8\x99\x54\x19\x39\xfd\x79\x98\x6d\x5e\xda\x0a\x1d\x76\x5e\x25\x6c\x97\xbc\xdd\x81\x1c\x88\xe2\x67\xc9\x3b\x93\x64\x18\x1d\xac\xa5\x2d\xef\x5a\x39\x12\xd2\xd3\x36\xe4\x3c\x3d\x7d\xff\x9e\xbc\x5d\x4b\xf6\x83\xf0\xf0\xed\x5e\x75\x86\xfd\x82\x9f\x1f\xba\xa6\x08\xc3\xe6\x2d\x19\xce\xef\x97\x49\x24\x1b\xeb\x56\x3c\x07\x14\x36\x50\x9e\x03\x09\xf6\xca\x27\x01\x8e\xfb\x3e\x2f\xc0\x9d\x25\xb7\x83\x3a\x43\xd1\x67\x49\x77\xc6\x0e\x34\x0c\x68\x23\x92\x65\x19\x10\x98\xdb\xbc\xa5\xcb\x70\x6c\x1e\xe4\xe8\xe0\xbb\xc3\xbc\xbd\xef\x38\x1a\xc7\x32\xfa\x41\xcf\x53\xfc\xa6\x6d\x2d\x4d\xc5\x6f\x1a\x36\xf4\xc5\x02\x68\xf0\x18\xa9\xee\x8c\xe1\x1a\xc8\xee\x21\x5f\x91\x1e\x80\x93\x6d\xa5\xbe\xb8\x63\xbf\xf1\x18\xc9\x95\x84\x5c\x05\xf9\xfc\x39\xaa\xfa\x7f\x23\xe8\x97\x2f\x97\x50\x9d\x1a\xbe\xd5\xf6\xff\x1d\x4d\x40\x0a\x7c\x07\x93\x11\x43\x1f\x9b\x29\x9f\xc1\xb3\x3e\x78\xfa\xf8\xfc\x01\x5e\x79\xba\x21\x22\x65\x0a\x4e\x13\xfb\xee\x49\xc2\x97\x9a\x0f\x1e\x93\x86\x2f\x50\xf9\x55\x89\xf8\x4a\x61\xef\x4c\xc5\x17\xa8\x1d\x27\xe3\xa4\x01\x67\xd2\xf1\x41\xc3\xc9\x03\x6d\x75\x6b\x9f\x51\x96\x52\xef\xd0\xc2\xa4\x71\x61\xdf\x97\x36\x63\x9f\x4f\xbe\x27\x61\xf7\xa4\x4f\xfa\x8b\xb7\xc5\x48\xde\xa3\x24\xed\xfe\xfe\x92\xfd\x9b\xbb\x1e\x43\xf3\x1d\x1a\xd6\x02\x9e\xaa\x89\xba\x6b\x6f\x37\xb5\x34\xdc\x84\x9b\x73\xe8\x82\x84\x5b\xde\x3e\x2e\xe9\xb6\xa3\x6b\x26\x70\x97\x36\x3c\x55\xbe\xe3\xe8\x2f\x7f\xfc\xb9\x5f\xf4\xfc\xe7\xbf\xa7\x96\x3d\x7f\xfc\x19\xd7\x39\x9c\x5b\x09\x95\xb6\x3d\x2e\xd3\x32\xe1\xd9\x45\xd4\x1e\xd7\x31\x9a\x50\x32\x7d\x0e\xc7\x92\x97\x06\xfd\x72\x38\x6b\x03\x53\x83\x07\x66\x79\xfa\xe6\x5c\x37\xc7\x09\xd6\x93\x0c\x30\x8e\x67\xd8\x93\x40\x21\x5d\x0d\x2c\x0e\x60\xe1\xda\xb5\xc1\xd8\x53\x35\xb4\x1d\x7f\x16\xfe\xf8\x33\xbe\x27\x3d\x4c\xd2\xde\x94\x79\x62\x6b\x30\xb6\xc9\x37\x4d\x68\x8f\xd3\xb9\xea\x1e\xd3\x59\xbf\x8a\x22\xbe\x6c\x0d\xe1\x51\x04\x5c\x8d\xb7\xae\x15\xb0\x77\xa9\xac\x89\xe8\xca\x36\x68\x6d\xdb\xec\xd2\x44\xda\x20\x6a\xf9\x3d\x8d\x17\x3a\xf8\xda\x42\xe7\x4c\x2d\x3b\x5a\x35\x8c\x56\xb2\xaf\xdb\xc7\x3d\x4e\x88\x94\x0d\x8e\x67\x85\x3a\xbb\xff\x4b\x23\x64\xe2\x82\xe5\x61\x62\xa6\xee\x11\x3d\x2b\xe8\x85\xec\x7a\x5a\xd4\x3c\x70\x01\xa2\x5a\xf6\x85\x13\x3d\x24\xcf\x77\xf8\x0b\xe2\x95\xc5\xb6\xd0\xea\x20\x65\xb1\x53\x3f\x38\xd5\xf3\x17\x23\x6d\xe4\x33\xf6\x82\x3c\xe1\xe8\xf6\x7a\x7a\x41\xf0\x17\x04\x7d\x41\x9e\x9e\x92\xd9\x39\x77\xaa\x76\x2d\x4b\xf1\x93\xb5\x2d\x5b\x4f\xd8\x58\x37\x75\x57\x07\xc6\x38\xe8\x72\xfa\xe6\xbc\x19\x4f\x3e\xaf\x18\xf7\x15\xa5\xbf\xa2\x04\x82\xb1\xdf\x71\xf6\x3b\xc9\x7c\x43\x09\x9c\xe4\xe8\x67\x14\xf7\x98\x4e\x85\x1d\x1f\x07\x4f\xaf\x1c\xcc\x88\xb4\x19\xbb\x96\xae\x9c\xa7\xc4\xd1\x14\x73\x0d\x25\x62\xbc\x74\xe0\x3e\xc8\xea\xe6\xd1\x13\x33\x67\xe9\x91\x24\x4a\xb2\xd7\xd0\x23\xc7\x40\x51\xc6\xf1\xba\xe3\x59\x1a\x14\x49\x11\xf8\x35\x34\xa8\x71\xb0\xac\xd8\x6e\x70\xfc\xf3\xea\xb3\x24\x68\x02\xc5\xaf\x12\x83\xde\x92\x08\xa3\x5f\x0a\x12\x2c\x89\x51\xd7\x90\x60\xc6\x73\x4b\xd1\xd5\x4d\x7a\x29\x58\x8c\xc6\xaf\x22\xc1\x1e\x48\x11\xb6\xa9\xa7\xa0\xc3\x90\x34\x71\x1d\x1d\x6f\xd2\x81\xa6\xd9\x50\x03\xae\x65\x9f\xb7\x29\x0e\xc5\x50\xee\x1a\xf4\x9c\x8f\x3e\xa8\x49\x8f\xd7\x8a\x7d\x1e\x3b\xce\x60\x57\x4d\x35\x86\xfa\xe8\xc3\x59\xf0\xab\x0c\xe7\x09\x50\x1c\x73\x95\x76\x30\x2c\x4a\x60\xb7\xfb\xf4\x02\xc0\x79\x42\x1c\xcd\x5d\x27\x09\x7e\x30\xd1\xe1\x7e\x3f\x78\x30\xfa\x1c\x25\x0c\x65\x28\xf2\xaa\x19\xc1\x88\x40\x9c\x5d\x79\xe5\xec\x8c\x63\x18\xce\xd0\xd7\x49\x42\x8e\x55\x7d\xbd\x7d\x48\xc4\x9a\x1b\x63\x55\x87\xc6\xd9\xd0\x88\x61\x14\x86\x5d\x15\x84\x31\x6a\xbb\xe6\xdc\x9e\x59\xac\x2f\x88\x41\x33\xd7\x85\x79\x8c\x1e\xeb\xa6\x06\x1d\x77\x7c\x7c\x2a\x72\x81\x14\xc3\xb1\xd7\xcd\x08\x73\x90\xea\xfd\xe3\x27\x70\x3e\x99\x60\x38\x8a\x12\xe4\x55\x44\xd8\x9d\xf9\xaa\x96\xbd\x5d\x94\x1f\xd0\xc0\xd0\xaf\x04\x86\x60\xe4\x77\x8c\xfb\x4e\x72\xdf\x30\x9c\x60\x09\xea\x19\xc5\xce\xe4\xf3\xb3\xfd\x1a\xd7\x26\xf4\xa3\x9e\x8d\xe8\x42\xa3\x98\x1d\x14\x9b\xaf\xfd\x5e\xb5\x5f\x1f\x96\x0a\xd5\x5e\xa7\xd2\xef\x51\x85\x62\x89\x27\xaa\xe2\x70\x88\xbf\x36\x2b\x35\xa6\xce\xbf\xf2\x5d\xa1\x59\xe8\xd2\xd5\x46\xae\x2d\x14\x7a\x83\xba\x18\x57\x50\x22\x11\xdc\x23\xc2\x53\xfd\x6c\x63\xc8\x53\x43\xb2\xcf\x0b\xa5\x41\xbf\x85\x77\x2b\x75\xbc\x5b\x27\xb3\xdd\x62\xa9\xdb\x64\x48\xa1\xdb\xa8\xd4\x45\xbc\x59\xea\x91\xfd\x56\xa9\x5e\x6e\x89\x95\x4a\xe9\x68\x16\x12\x89\x10\x1e\x91\xdc\xa0\x52\xa4\x5b\x22\x59\x17\xcb\x42\x23\x57\x13\x0b\x59\x86\xc0\x79\x92\xa0\x47\x54\x43\xcc\xb7\x5b\xd5\x62\xbf\xc2\x14\xb3\xd5\x5c\xad\x59\x2d\x17\xea\x64\x9b\x11\x86\xfd\x5e\x37\x35\x11\xd2\x57\x57\xab\x31\x2c\x95\xab\x78\xae\x4c\x14\xc4\x26\x99\x1d\x54\x0b\x35\x31\x5f\x2d\xbc\x76\xc5\x46\x17\x2f\x0d\x89\x51\xad\xd0\x2e\xd5\xc5\x6e\x4e\xa8\xf3\xed\x3e\xd3\xcc\x31\xf5\x01\x5e\x7a\xba\xb5\xbf\xc8\x5b\xca\x5e\x98\xeb\xb0\x27\x73\xdf\x4e\xfd\xcd\x81\xe7\x7b\x6f\x5e\x10\xf2\x05\x71\xed\x25\x4c\x61\x81\xc7\x5d\x35\x37\xdb\x5f\xb0\xd3\x8a\x5a\x9f\x6c\x43\x45\x77\xc7\xc0\x58\x4c\x80\xb9\x9c\x93\x9e\xcf\x74\xdb\xf9\xa7\x3b\xa7\xf3\x96\x3e\x92\x87\xe8\xf9\x60\x5f\xf8\x82\x60\x69\xb5\x7c\xaa\x8d\xe4\x56\x35\x6f\x5b\x49\x22\x7a\xc6\x18\x2f\x78\x32\x04\xce\x62\x3e\x53\x9e\x4f\xfe\xe7\x53\x90\x0c\x3f\x7d\x47\x3e\x61\x28\xfa\x2d\xdc\x6e\x7c\x7a\x41\x3e\xed\xbb\x95\xbc\x9b\xdd\x76\x7e\xff\xa5\xbb\x59\xf8\x5f\xc6\x27\x6e\x0f\x11\x74\x2d\x79\x30\xb7\xce\xe0\xa7\xff\x26\xb9\x64\x5c\x34\x22\x26\x1a\xfe\x82\x10\xff\x23\xa2\xe1\x3b\xd1\x18\x82\x61\xfe\x47\x67\x2d\x10\xed\x7f\x6c\xd6\x70\x96\x25\x39\x94\xe2\x58\x2a\x98\x35\xd4\x97\xcd\xd0\xe7\xba\x2f\x1a\x87\xe3\x04\xc1\xe0\x28\x41\xb3\xd4\x37\x92\x61\x28\x16\x65\xfe\x51\x32\x62\x5b\x19\x31\x14\xdd\xc6\x93\xff\x35\x19\x89\x17\x84\xa5\x58\x8e\x23\x58\x9a\xe5\x7c\x11\x03\x09\x1d\x17\xd8\xae\x6e\x6a\x63\x09\x18\xc0\x94\x61\x68\xab\x7b\x63\x4d\x4d\x81\x3c\xa4\x70\xda\x07\x4e\x38\xc1\x56\x4f\x26\x70\xf5\x77\x78\xb3\x44\x9e\x0f\x06\x22\xad\xa0\xae\x4d\x3c\x82\xd8\x0b\xf2\x29\x48\x32\xe3\x19\xdc\xfc\x32\x5b\xf2\xb9\x22\x71\x26\x74\x97\x9f\xa5\xe7\x90\xc2\x4f\xd7\x73\x4c\xa2\x74\x7a\xbe\x71\x0d\x7e\x55\x5c\x0a\xb8\xa2\xd9\xd0\x65\x7f\x9a\x9e\x03\x0a\x3f\x5d\xcf\x31\x89\xd2\xe9\xf9\xc6\x6d\x48\xc0\xd5\x85\x25\xdc\xa9\x0e\xd8\x5b\x97\x70\xdb\x2e\xd8\xad\xb0\xd4\x0b\xf2\x44\xd3\x32\x2b\x11\x04\xc5\x29\x80\x81\xaa\xa2\xd0\x98\x4a\xa9\xb8\x44\x30\x28\x8d\x73\x18\x8d\x53\xa4\x4c\x93\x18\x4b\x13\x84\xac\xe0\x18\x8e\x91\x04\x43\xa2\x32\x23\x2b\xa8\x04\x51\x96\xa2\xbc\x35\xb5\xa4\x62\x1c\x4b\xcb\xb8\x24\xa9\x8a\x84\xcb\x2c\xcd\x90\x0a\x41\x4a\x1c\x84\x18\x81\x32\x92\xaa\x92\x32\x2a\x63\x40\x92\x50\x0a\x87\x9c\xca\x00\x15\xa0\x0a\x43\xcb\x50\x26\x70\x89\x52\xd9\x27\xdf\x6e\xd0\xd8\xe6\x99\xfe\x4e\x90\xdf\x09\x2e\xbe\xa7\x0e\xbf\xfe\x46\x61\x04\xc9\x51\x17\xef\xe2\x18\xc9\x90\x2c\x41\x93\x2c\xfa\x82\x60\xb4\x37\x9f\x47\xd7\x0b\xc2\x79\xff\x61\xe1\x7f\xdb\x2f\xb1\xdd\x1f\xde\x9e\x82\xe7\x79\x3e\xc7\xb0\xa3\x89\x53\x61\x32\x52\xb5\x3c\x42\x51\x74\x09\xc9\x4e\x96\xc9\xa0\xab\x5a\xd1\x76\x0a\xd5\x05\x47\x3f\x6b\x18\xfe\xe1\xd4\xec\x01\xf9\x66\xad\x45\x7b\x3d\xc5\xcc\x02\xfb\xdc\x2d\x97\xe9\xbe\x38\xcb\x7f\x18\xd3\x56\x0b\xda\x44\x6f\xd9\x9a\x7d\xb4\x5f\x47\x7c\xb3\x49\x32\x9d\xa6\x87\x9a\x1f\x34\x7a\xb5\xd2\x8a\xdf\x5d\x50\xa9\x16\xe6\x5c\x4e\x1b\xf4\x18\x8e\x5f\x8e\x44\x0e\x68\x05\x71\x6d\x8f\xf2\x4d\xad\x47\x48\xaa\x51\xe4\xdf\x1a\xcc\xf3\xba\xac\x8e\x72\x9d\xfe\x26\xbb\x50\xda\x5d\xb2\xc8\x0e\x17\xae\xa2\x94\x2a\x2b\xe3\xbd\xe1\x64\xe5\x61\x7f\xad\x94\x67\x9b\xf6\xab\x36\x55\xa8\xcd\xaa\x56\xd0\x3c\xcc\x5d\x91\xac\x82\x8f\x05\xde\xdc\x13\xe3\xeb\x02\x7f\x78\x65\xbd\xff\x46\xfc\x00\x23\x9b\x3c\x9f\x47\x5f\xf9\x7f\xda\x15\x18\x15\xf6\xe2\x1f\xd3\x26\x78\x7f\xdc\x21\xc8\xc7\x18\xf3\x13\xc0\x49\x0e\x57\x38\x8e\x01\x32\x46\x10\x2a\x87\x62\x04\x54\x65\x9c\x62\x55\x89\x92\x64\x8a\x90\xa0\x8a\x72\xac\xa4\x72\x1c\xab\xc8\x14\x2b\x4b\x14\xaa\xca\xb4\xca\xb2\x12\xa3\x02\xd6\x3f\x9c\x21\x82\x48\x77\x6c\xdb\x6c\xa2\xc9\x13\x28\x4d\x24\x3b\xc4\xf6\x6e\xb0\x46\xa6\x39\x8c\x25\xcf\x38\x04\x9b\xd2\x21\xe8\xd7\xd7\xea\xc8\xa0\x57\x9d\x06\xc5\x77\x18\xf6\x75\xf8\x8c\xbd\x17\xea\xcf\xec\xab\x9e\x99\x0f\x89\xc2\xb4\xda\x6d\xac\xdf\xf5\xaa\x4a\x6b\x7c\xd7\xa8\x2e\x6d\x4c\x1f\x14\x4b\xf3\x61\x97\x6a\xcf\x5b\x25\x45\x2d\x34\xb9\x4d\x3d\xff\xc6\x19\x85\xda\xa6\xf0\x46\xa2\xf4\xab\x23\x31\x83\xc0\x0b\x7c\x87\xd0\xf6\x13\x9a\xb1\xdf\x3a\xd3\x72\xb5\xdf\x79\x57\x84\x67\x1c\x95\xdc\x0f\x05\x00\x8e\x10\x1a\x6e\x77\x56\x20\xfb\xed\x3a\x5b\x29\xb7\xf8\x0d\x57\x2e\xe7\xd8\x57\x1c\xef\x39\x80\xe0\x96\x6d\xd7\x25\xc8\x3c\xd7\xb4\x6a\xd3\x0e\x95\x21\xb5\xae\x54\x00\x6e\xa6\x6c\xf4\x81\xa8\x29\x06\x55\xf2\x7d\xa0\x79\xc2\x21\x6a\x5a\xcc\x9e\xfe\x17\x1c\x82\xf0\x7d\xe2\x0a\x87\x20\x1e\x63\xcc\x4f\x0c\x85\xd2\xac\x0c\x64\x5c\xc5\x20\x0d\x50\x09\x97\x81\x0a\x70\x85\x52\x24\x49\x96\x65\x4a\xc6\x38\x9a\xc1\x18\x95\x56\x55\x95\x65\x38\x4e\x96\x09\x20\xd1\x80\xe6\x28\x09\x65\x24\x0e\x03\xc1\x69\x25\x7e\xd2\xb6\x99\x44\x93\x27\x71\x1a\x4f\x76\x17\xef\xae\x97\x5d\xc2\x9d\x15\xc6\xb2\xec\x19\x87\xa0\x52\x3a\x04\xd1\x2d\x4e\x2b\xab\xf7\xd2\xdc\xaa\x56\x2b\xcf\x3a\xa6\x2c\xd9\x8f\xc2\x6a\x34\x5a\xab\x78\x26\x33\xa1\xcc\x5a\xdd\x06\x73\x43\xca\x32\x33\x20\x7d\xbc\xa3\xcd\x62\x63\x56\x1c\xb4\x65\x5c\xd6\xb2\xb9\xfc\xc2\xd2\x75\xa1\xd8\x22\x55\x7c\x6e\xa3\x8b\x2c\x57\x04\xcc\x50\x7b\x1e\x48\x65\x7f\x02\x7d\x87\x88\xd8\x68\xbb\x55\xed\x76\x4b\x4e\x36\x93\xf9\x28\x39\xd3\x12\x6f\x61\x23\xbe\x9b\x9d\x59\xec\x9a\x6c\xb7\x06\xe2\x06\xa8\xee\xe8\xad\x67\x16\xa8\x5a\x69\xea\x8e\x2c\xe3\x55\x5d\x03\xb5\x0e\x56\x99\x0e\x41\x74\xbb\x2b\xe3\xa3\xa6\xd4\xeb\x95\x81\x06\xc5\x7c\x16\xeb\xc0\x37\x21\xcf\x59\x43\x1f\x7f\xed\x84\x43\x94\xd0\x53\x46\xf5\x0f\x77\x08\xfc\x5a\x87\xc0\x1f\x63\xcc\x4f\x34\xa1\x70\xac\x4a\x11\x34\x84\x34\xab\x60\x12\xce\x48\x94\xc4\x72\x2a\x4e\x00\x95\x22\x30\x4c\x62\x28\x9a\x03\x38\xa9\x02\x15\x23\x51\x02\x28\xa8\x44\xe1\x12\x4d\x10\x1e\x0e\xc8\x71\xe7\x32\x04\x9d\x68\xf2\x14\xc9\x90\xc9\x0b\x2a\x8a\x64\xbc\x04\x11\xec\xe7\x48\x8a\xc3\xcf\xb8\x03\x91\xd2\x1d\xf0\xc6\x68\x8a\x89\x4b\xca\x42\xa5\x57\xa6\x4f\x9a\x9b\xfa\x7b\x77\x5d\x24\x7a\x0b\x6b\xf6\xfc\x5e\xe0\xeb\x6e\x0e\xab\xe0\x35\x26\xcb\xd0\xa3\x4c\x8d\x2a\xb7\x73\x6f\x2d\xe2\x79\xf1\x51\xe8\x57\x9a\xf5\x0f\x41\xd3\x35\xc3\x25\x5f\xdb\x3c\xcc\x33\x43\xdb\x72\x04\x50\xcd\x50\xe5\x6a\xb0\x56\xf1\xdd\xc1\xff\xab\xbc\xfb\x8f\xf7\x2d\xd6\xd9\x7f\x5e\xf1\x8d\xe6\x2c\x98\x6e\xb4\xd7\x64\x97\xf3\x45\xad\xfe\xdc\x7a\xcd\xe4\x3e\xca\x68\x6f\xf4\x0a\x9f\x29\x38\x59\x65\x66\x64\x87\x54\x26\xab\x46\x73\xb5\x12\x7a\x0c\x33\x37\x47\x80\x9e\xf4\xaa\xd5\x6e\x56\x28\x81\x65\x06\xae\x5f\xe9\x99\x58\x2b\x7f\x7c\x34\x7a\xef\xd8\xa0\xce\xc1\xd5\xa2\xb4\x1e\xf4\xf8\x42\xc3\xcf\x12\xe5\x13\xee\x22\x38\xa7\x4c\xee\x1f\xee\x2e\x57\xe7\x0f\xec\x31\xa6\xee\x77\xda\x6d\xf7\x08\x18\xc7\xa0\x5f\x51\xec\x2b\x8a\x21\x28\xfa\xdd\xff\x97\x68\xd2\x34\xcb\x50\xc9\xf9\xc1\xbb\xeb\xe5\x07\x12\xe7\x48\x8e\x66\x70\x8e\x3e\x63\xf1\xa7\xed\x3d\x60\xe9\xaf\x9e\x9a\xe4\x2b\x3b\xa8\xe8\xe4\x26\xb3\x69\x57\xb2\x4c\xde\xcc\x73\x25\x1c\x5d\x4f\xb3\xcf\x0e\xaa\xb9\xce\xaa\xbc\xfa\xc0\x06\x4a\xbb\x3f\x04\xd9\x57\x10\xec\x0d\x84\x13\xa6\x7c\xfa\xda\x9a\x32\xcf\x67\x67\xbf\x40\x90\x87\x5e\xbb\x0d\x67\x68\xca\x17\xf6\xe0\x29\x1e\x85\xbb\x75\x4b\x9e\xd0\x61\x17\xf1\x9f\x60\x03\x4b\xa2\x94\x5f\xae\x4f\xf0\xbb\x0b\x68\xf0\x18\x1a\xfc\x36\x34\xf1\x73\x11\xe2\x36\x34\x64\xfc\xe4\xe8\x36\x34\x54\xac\xde\x7f\x23\x37\x74\xfc\xd8\xe0\x36\x34\xcc\x16\x0d\x8b\x91\x0c\x71\x33\x37\x6c\xac\xd2\x7f\x23\x37\x5c\xbc\x98\x7e\x1b\x1a\x0c\x3d\x2c\xef\x92\x37\xa2\xc1\x62\x55\xe2\x1b\xd1\xe0\x87\x45\xd0\x5b\xb9\x21\x62\xd5\xe1\x1b\xd1\xc4\x4a\x93\xb7\x72\x43\xc5\x2a\x9c\x8f\x79\x3a\xf5\x21\xe7\xce\xe7\x5b\x77\x5f\x10\x8f\xf7\x74\x07\xd1\x09\x0f\x69\xde\x1d\x35\x23\x21\xee\x20\xbe\xed\x3e\xd0\x7e\x09\x08\xf3\x4b\xb8\xae\x75\x57\xb5\xf6\x05\xf9\xa4\xda\xd6\xfc\xae\xca\xfa\x0b\x12\xa9\x5c\xe3\x7f\xb7\xd3\xc8\x9f\xd0\xb7\x73\x62\xa6\x0e\x63\xff\xee\x03\x7a\x3c\x53\x77\x68\x79\x37\x53\xb7\x6a\xe3\x60\xa6\xfe\x76\xe7\xc6\x3f\xa1\x2f\x29\x79\xa6\xc2\x4e\x81\xdd\x87\x9f\xe4\x53\xff\x7f\xa6\xee\x9d\xa9\x70\xe9\xb1\xff\x80\xfb\xd3\x14\x9c\x98\xf9\xed\xb6\x9e\x30\xe8\x37\x2a\xa2\xa0\x9d\xe6\xc8\x43\xcd\x05\xcf\x00\x7b\xd2\xff\xe7\x93\xf2\xe9\x3b\x82\xbf\x20\x9f\xcc\x4f\xdf\x11\xec\xbf\x2f\xc8\xa7\x6d\x2f\xea\xa7\xef\xde\x22\xfa\x93\xb4\xdc\xe8\xa6\x36\x3e\xa9\xec\x83\x7b\xe7\x74\xee\x40\xc3\x38\x86\x0c\xcf\xef\xe2\x88\xfe\x49\x53\x73\xd0\xb8\xb1\xfb\x40\xfa\x53\x43\xa7\x6b\x70\x70\xed\xa5\xe3\x42\x78\xaf\x9b\xf8\x68\x2c\xfb\x5e\x8f\xfd\x7b\x38\xd5\x83\x7b\x3f\x13\x67\x6e\xbb\x82\xde\x7d\x40\xff\xe2\x99\xbb\x67\xed\xf1\xb7\x98\xb9\x9f\xbf\xc4\x88\x6e\x36\x76\x7f\xb3\x91\x06\x05\x75\x69\x2a\xa1\x2c\x37\x76\xde\xfa\x7a\x09\xfa\x5f\xef\x9d\xdc\x14\xdd\x12\x77\xb6\x08\x5f\xa3\xb6\x70\x57\xb4\xfb\x9b\xfc\xa9\x6a\xbb\xc3\x98\xff\x66\x6a\x0b\xb6\x6f\xbb\xbf\xd1\x9f\xaa\xb6\x3b\xa2\xf7\xcf\x57\xdb\x85\xbd\xe0\x89\xb7\xcb\xa4\xd9\x07\x5e\xc6\x7a\xf9\x7d\x19\xb7\xee\x37\x13\x1f\x10\x3d\x59\xa7\xa3\x93\x6b\x0a\x17\x11\xe1\x31\x44\x49\xf5\x9f\x8b\x88\x88\xd8\xde\x2a\xa9\xe6\x72\x11\x11\x19\xdf\xa4\xdd\x8a\x88\x8a\xed\x21\x6e\xe6\x88\x8e\x21\xba\x59\x47\x4c\x6c\xad\x7c\x33\x47\x6c\x6c\x65\x77\x33\x47\x5c\x7c\xa1\x71\x2b\xa2\x83\xca\x1d\x9b\x5c\x9d\xba\x8c\x08\x3b\x44\x74\xb3\x8e\x0e\xaa\x77\xe4\x3d\x1c\x11\xb1\xec\x74\x33\x22\xf2\x30\x5e\xdf\xce\x11\x75\x88\x28\xb9\x86\x77\xed\xfb\x5e\x1e\x51\xc5\xbb\xf4\x5c\xfa\x35\x75\xbc\xc4\xb7\xbb\x3c\x20\xb2\x46\x9e\x7e\x03\x00\xa3\x59\x15\xc3\x31\x9c\x94\x18\x19\xe3\x68\x19\x05\x0a\x80\x90\x91\x19\x02\xd0\xa4\x42\x30\xaa\x37\xfd\xac\x0c\x64\x89\xe2\x00\x87\xa9\x2a\xc1\x72\x34\x4e\xb3\x24\x05\x19\x59\x7d\x7a\x41\x82\xb6\xdf\xdb\x17\x9b\x91\x73\x70\x72\x7b\xf2\x97\xdc\x6b\x48\x13\x67\x1a\x11\xfd\x9b\x07\x51\x3d\x38\x30\x2c\x52\xd6\xab\xdb\x53\xcc\x61\xbd\xa7\x8c\xde\xdc\xc1\xa2\x53\xca\xba\x92\x3c\x44\xe7\xb9\xb9\x2a\x67\xcb\x15\x41\xeb\x9b\xc6\x7b\xa1\x3c\x01\xbc\x7f\xe0\xc6\x6f\x8f\xb5\x73\xb1\xf3\xac\xec\xfe\xcf\xe0\x6c\xbc\x8e\xe7\x32\x7c\x9d\xa4\x86\xd9\x3c\xe1\x96\x7a\x85\x3a\xd6\x22\x78\xb4\x06\x67\x0d\xf6\xb5\x45\x9b\x22\xc6\x73\xb0\xaf\x2b\x9b\xb2\xdb\xf5\xc7\xf7\x7a\x62\xd8\x00\x98\x5b\x5a\x84\xe5\x92\xd4\x5b\xae\x21\xac\x17\xcd\x0c\x61\x95\xc4\xe7\x0f\x8c\x69\x6d\x74\x07\x33\xd4\x5a\x61\x38\x6f\xf6\x35\x7b\xd9\x7e\xee\x04\xa4\x09\x71\x14\x3d\x2c\x2c\xec\xf8\x6d\x56\xe4\x62\x9b\xab\x3b\x3d\xb3\x57\xca\xf5\xca\x25\x94\xcc\x71\xa3\xca\xc7\x47\x65\x98\x6d\x29\xb9\xf9\xe6\xf9\x75\x35\xff\x30\x14\xa6\x29\xf3\xd5\xfa\x7a\xd4\x95\x79\x6d\xb6\x2c\xaa\x56\x5b\x79\x1f\x2c\x4a\x04\x3b\x17\xdf\xed\xb7\xa6\x0e\x6a\x4e\x5b\x9c\x77\x5e\xfb\xc3\xd6\x47\xe9\x5d\xb3\x7e\x3c\x45\x0f\x5c\x8b\x9d\x8c\x77\xf9\x7f\xef\xd9\xc8\xfa\x5f\x06\x1d\x5c\x7b\xf8\xe6\x4e\x7f\x79\x1f\x28\xc2\xb6\x34\xd7\xe6\x58\x0f\x57\x34\xaa\x87\xcd\xdf\x30\x68\xd4\xe4\x22\xe6\xae\xa7\xed\x61\x65\xc4\xad\x04\xcd\x6a\x67\x01\xec\xb3\x5d\xbd\x60\xf9\x4a\xea\xf1\xef\xd3\xfa\x7e\x3e\xb2\x31\xfa\x07\x73\x71\xe2\xca\x3e\x98\x7e\xee\x4a\xfa\xfc\x4e\x27\xbe\x8e\x6a\x3b\x9d\x84\xec\x2d\x41\x4e\xea\x0d\x46\x78\xde\x18\xf4\x81\xdd\xa3\xbb\xeb\x95\xd4\x27\x8a\xe2\xab\xb6\x30\x09\xbe\x9d\x9b\x94\x0b\x0b\x4a\x5a\xb7\xcb\x7d\x7f\xfc\x6b\x37\xf7\x5c\x97\xf7\xf8\x04\xfe\xd0\x26\xc3\x2b\xf1\x4c\xd9\x87\x2f\xdc\x47\xbf\x46\xde\x46\xff\x87\x6f\x1f\xff\x59\xac\x46\x55\x94\x5e\xf7\x95\xae\xfc\xda\xd5\xd4\x8e\x56\xc5\x66\x76\xa3\xb6\xd0\x0a\x05\xb4\x22\x55\x49\x33\x27\xd5\x7b\x84\x9b\x5d\xf1\x0e\x53\x30\x5a\xab\x5c\xae\x4d\x8e\x9e\x27\xaf\x38\x07\x67\xaa\xba\x19\xe2\xcf\xcb\x45\xee\xd5\xda\xac\xcb\xf8\xa8\x66\x8c\x26\xa5\x1a\x7c\xce\x69\x3f\x7e\xf8\x8b\x69\xff\x2d\x42\xdb\x2e\x86\x34\xff\xfb\x2f\xfb\xf7\xa3\xce\xe5\x94\x14\x7d\x5b\x03\x0d\x09\x1c\xa3\x51\x92\x52\x28\x86\x93\x20\x20\x51\x15\x57\x08\x0a\xa0\x1c\x89\xd2\x0a\x24\x00\xcb\x91\x50\x96\x28\x09\x32\xa8\x22\x29\x80\x82\x32\x27\xa3\x24\xce\x00\x54\xa1\x00\x16\x3c\xc0\x89\xdd\x53\x17\x8b\x84\x4d\xe2\x52\xd8\x24\x50\x86\xc3\xce\xf4\xab\x06\x77\x0f\x16\x9f\x81\xd1\x56\xe8\x29\xd4\x89\xe9\xdc\x2a\xb3\x9d\xa2\x91\xcf\x40\x4d\x26\x98\xc6\xc0\x2d\x55\x2a\x1f\xfd\x1e\xbb\xea\xe9\xa3\x2c\xc8\x2d\xa9\x2a\xe5\x5b\x76\x24\x70\xc6\x8d\xe2\x28\x70\x5e\xe9\x88\x77\x04\x4e\x9e\x99\x3b\x56\x84\x95\xe2\x8e\xdf\xa6\x60\x56\xf2\x52\x7e\xf8\x5e\x99\xbd\x4e\x87\x15\x14\xd8\xef\x93\x82\x61\x3e\x17\x2b\xe8\x33\xc3\x6f\x68\x0d\x05\xcf\xd8\x64\xda\x6a\x41\x43\xe0\x21\xb9\x9a\x4f\xe1\x9b\x28\xb7\x34\x7c\x4e\xe6\x4c\xc6\x25\xf9\xe9\xeb\x07\xef\xe4\x9b\x65\x54\x1f\x80\x49\x51\xb2\x5e\x1b\x65\x91\x5f\xc5\x02\x67\xf3\x94\x63\x44\xf5\x93\x1c\x38\x23\x40\xf6\x9b\x48\x57\x61\x1d\x68\xd3\x75\x0d\x74\x1b\x1c\x9d\xfd\x50\x1d\x0e\xa2\xb2\x65\x8b\xa3\xc1\x47\xb6\xff\x3a\x2b\x58\x15\x66\xf6\x3e\xf3\x9b\x7a\xbd\xc0\xa5\x63\xfb\xf9\x48\xb8\x2e\x04\xce\xc7\xd1\x3f\x0e\x12\x29\xe8\x1f\x05\xcd\xa0\x0b\xe6\xca\xa0\x55\xe8\x75\xd1\x50\xf1\x57\xda\x73\xc8\x4a\x66\x77\xad\x4e\xf1\x2c\xec\xbf\xfc\xd5\xfc\xe5\x97\x60\xa3\x9d\xe3\xef\xc7\x8f\x13\x09\x28\xb2\xa8\xb9\xd6\x97\xbc\x04\x10\xf2\x1a\x6f\xdb\x8e\x5e\xe7\x13\x90\x70\x1f\xfd\x68\x02\xbc\x86\x7e\x98\x80\xda\xb2\x25\x3a\xa2\xce\xbe\x35\xe7\xa2\x66\xb7\xde\x96\xcf\x42\xbf\xaf\x92\x43\xbb\xc3\x38\xf9\xea\x5b\xbe\x65\x33\xfd\xa2\x58\x28\xd0\xdd\x66\x96\x99\xe6\x80\x48\x5b\xd8\xba\x98\x07\x92\x56\x51\x97\x84\x96\xab\x99\xb5\xdc\x4a\xe4\xa7\xed\x57\xe5\x4d\x18\x2d\xb5\x19\xab\xa1\x79\xfe\xd6\x04\xe4\xed\x06\xae\xcf\x3f\x98\x4c\x52\x24\x4d\xa0\x38\xcd\x00\xc0\x32\x34\x03\x65\x56\x66\x21\x81\x92\x14\x2a\x43\x40\x4b\x80\xa6\x51\x8c\xa4\x20\x27\x73\x38\x09\x24\x89\xa1\x14\x06\xd0\x34\xcd\x49\xb4\x8c\xb3\x20\xc8\x3f\xf8\x83\xf2\xcf\xc5\x65\x3b\x81\x72\xc9\xcd\xb0\xe1\xcd\x83\x42\xc3\xbd\xd9\xe7\x6f\xb4\x6c\x3f\x93\x7d\xf2\x8b\xf2\x8c\x7b\x23\x50\xf7\x43\x6d\xce\x16\xcd\x65\x6e\x55\x60\x74\xd0\x20\x24\x91\xce\xb7\x72\xb3\xe7\x55\x97\xe8\xb1\x34\xe3\xbe\xcd\xaa\xcd\x1e\x51\x56\x48\x0a\xef\x3b\x95\xee\x70\xd1\x68\xda\x22\x0b\xa7\xb4\x3a\x43\x97\x6b\x08\xe7\x59\xd1\xf9\xc0\x44\xaa\x57\x73\x38\x6d\xf8\x77\xcc\x3e\x37\x45\xff\x07\xd2\x8f\xdb\x43\x2a\xfa\xa7\xb3\x0f\xcf\x0c\xab\x2c\xcf\x4c\x0d\x4d\x68\x40\x54\xe9\x76\x99\x5e\x49\xce\x37\xd7\x74\x33\xb3\x32\x4a\x6f\x32\xd1\xcd\x63\x14\x78\x25\xca\x3a\xe6\xc3\xff\xea\xec\xf3\x0b\xf9\xbb\x2d\xfb\xfc\x45\xd1\x9f\x7f\x50\xf6\x89\x6e\x7f\xae\xa1\x1f\x66\x9f\xfa\x4c\xef\xe0\xb6\xda\x26\x44\x2e\xd7\x36\x72\x64\x95\x1f\x2c\x5f\xad\x8c\xe2\x10\x96\x28\x54\x3a\x4c\xb6\xa3\x0c\x3e\xec\x25\xfe\xd6\x74\xb3\x03\x79\x42\x4c\xcd\x11\x58\x2d\x5a\xfa\x8c\xcb\x39\xc4\x9a\x6e\x2c\x9e\x3b\x6d\xa6\x40\xd1\x43\x01\xff\x68\x74\x09\xa3\xbb\xf9\xc0\xb3\x37\x6f\x7f\x6e\xcb\x3e\x1c\x94\x20\x54\xa0\x24\x53\xb8\x02\x08\x8c\x55\x68\x49\x21\x28\x92\x26\x49\x82\x23\x38\x06\x55\x14\x86\x42\x69\x49\x62\x25\x15\xb0\xb4\x4a\x13\x32\xcb\xc9\x14\xcd\xb0\x32\xca\xc8\x94\xff\x5c\x04\x19\x34\x4b\x3c\x22\xfb\x50\x17\xb3\x0f\x86\x31\x67\x9e\xe5\x0b\xef\x1e\xd4\xa7\xef\xcd\x3f\xf9\xd8\xe4\x47\x42\x59\xc4\xb5\x7b\xbd\x4e\x2b\xfc\xf3\xca\xf8\x16\x49\x2a\xbe\x39\x9f\x8e\x6f\x60\x0b\x9f\xe5\xdf\x9d\x25\xa5\x3e\xbf\x33\x3d\xfb\x35\x5f\xaa\x2c\x71\xb6\xbf\x12\xf0\x8f\x55\xbe\x49\x19\xb5\xbe\x99\x63\x0a\x96\xd6\x36\x3a\x19\x71\xba\xd6\x4a\xeb\x3c\x33\x9b\x8d\x4a\xb5\x3e\x6e\xcc\xa6\xc3\x75\x86\x6b\x93\x94\x53\x7e\x2d\xe6\xea\xe4\xfb\x94\x7e\xd6\xca\xef\xeb\x92\xbd\xa2\x8d\x6c\xd4\xbf\xf9\xc4\x5c\x13\xd7\x05\x7f\x8b\x6e\x23\xb2\xfe\x74\xdd\xfd\x82\x7c\x78\x53\x3e\x7a\x20\xfd\xd3\x73\x72\x29\x1f\xfa\xa8\x1e\x11\xc3\xab\xfe\xa2\x2a\x92\x13\x8e\xaf\x9f\x1a\xc3\x8f\xe8\x5f\x2a\x61\x1d\xdd\x8f\x2d\xea\xe2\x03\x83\xf9\xfd\x27\xd8\xf8\xc3\xf2\xf2\xad\x79\x91\xff\x09\x73\x7a\x0d\xfd\x30\x2f\xff\xac\x00\xf9\x2b\xf3\x32\x85\x61\x00\x53\x71\x0a\x62\x2a\x05\x01\xae\xc8\xa8\x84\x62\x1c\x4e\x60\x2a\x64\x38\x9c\x21\x54\x59\xc6\x19\x92\xc1\x65\x9c\xa0\x65\x8a\x63\x51\x55\xe6\x14\x59\x51\x68\x85\xc3\x28\x88\x87\x0f\xc3\x63\xf7\xf4\x7c\x5d\x53\x95\x24\x71\x96\xc4\xcf\x3c\x34\x1c\xdc\x3d\x38\xee\x0d\x6c\x36\xef\x6a\xef\xab\xfc\xb2\xde\xe7\x9b\x1c\xd3\xc2\x5a\x1d\xb7\xab\xac\xc4\x7c\x69\x91\xcf\xe4\xba\x70\xf1\xa1\x34\x1b\x03\xc3\x32\x65\xbd\xda\xe3\x53\x57\x25\x87\xfc\xcd\xfb\xbc\xd2\x7e\x09\x1c\xb1\xe9\x1d\xfd\x66\x49\xc0\x16\xcf\x94\x9b\x6d\xbc\xb1\x8b\xae\x55\xe4\x07\x6f\x75\xae\xcd\x80\x15\x55\xe7\x24\x93\x65\x5a\x9b\xc6\x0a\x1d\x60\x4a\x05\x55\x98\x49\xbb\x45\x33\xcb\x62\x66\x36\xe1\x37\x39\xc2\xe2\x3a\x76\xa3\x43\x7f\x70\xca\x68\x36\x99\x0f\x32\x22\x3f\x63\xcd\xf5\x9c\x9b\x18\xc3\xa6\x90\x26\xf7\x16\xa3\x86\x9e\x94\xd7\xf8\xc8\xbb\x30\xae\xdc\x17\xfb\xc7\x23\xe6\x5e\xbf\x09\x57\x9a\xbc\xf2\x10\xfa\xb7\x55\x19\xf7\x79\x2d\x9a\x17\xaf\xdc\x47\x9d\x3c\x9a\x39\xbe\xce\xc7\xc0\x47\xd3\xbf\xe2\x68\x88\xe7\xff\xbe\xfb\xdc\x4b\x55\xcc\x5b\x74\x75\x77\x15\xf3\x81\x73\x75\x0d\xfd\x30\x5f\xc9\x9d\xbe\xc9\xcc\x51\xe1\xd9\xde\x18\x6d\x6d\x98\x85\x16\x83\x55\x5d\x3b\x3f\x63\xb0\xa5\xfa\xe1\x96\xca\x99\x7c\x4b\xed\xa1\x76\x8b\x58\x16\x5e\x4b\xf6\x92\x94\x9e\xdb\x42\xbe\x5c\x85\x53\xac\xee\x70\x0d\xbb\x81\x61\xf3\x76\x71\xa4\xb2\x68\xae\xb3\x51\x8b\x12\x5e\xec\x4d\xf8\xe6\xaf\xcd\x57\x00\x57\x80\xa4\x92\x90\x53\x30\x9a\xc4\x19\x1c\xa7\x51\x1c\x67\x70\x88\x31\x2c\x20\x18\x99\x63\x08\x99\xc3\x18\x46\xe2\x28\x46\x01\x2c\x8d\x71\x38\xe0\x38\x89\x80\x9c\x4a\x00\x0e\x00\x32\xc8\x57\xf8\x83\x9a\x0f\x2e\xe7\x2b\x02\x43\x93\x4f\xd1\xb6\x77\x0f\xba\x8a\xee\x6d\x3f\xf8\x85\xf9\x2a\xd2\x4e\x50\xd2\xab\x0b\x41\xec\x33\xc4\x54\xee\x60\x6d\x65\xa6\x66\x20\x58\x4f\xdb\xd5\x62\xa7\x99\xd3\xca\x26\x44\x5d\x82\x04\x65\xb8\x51\x26\x0b\xa3\xe7\xf6\xb9\x75\xbe\x49\x4f\xf8\x0e\xc1\x16\xb9\x99\x6e\x57\x2a\xad\xf2\xc6\xaa\x2c\x67\x56\x57\x14\x27\xfc\x4a\xe9\x6f\x32\x8d\x69\x53\xfe\x29\xf9\xea\x96\xe3\xfc\x47\xe6\xab\x3b\xe9\x3f\x30\x5f\x3d\xa4\x95\xe0\xf8\x4a\x1d\x03\x7f\x75\x2b\x03\xcf\xff\x7d\x4f\x05\x2f\xe5\xab\x5b\x74\xf5\xc8\x7c\x75\xef\x5c\x5d\x43\x3f\xcc\x57\xb0\xbc\x9c\x35\x31\xe9\x1d\x8a\xeb\x46\xef\x15\x6f\x65\x38\xca\x2e\x8a\x65\x67\x24\xf2\x15\x5e\x57\x98\x36\xa1\x4e\xac\x09\xf3\x8a\x17\xe7\xbd\x3e\x26\x11\x82\x98\x7f\x13\xb2\x0d\x75\x25\xe1\xed\x8a\x63\x2d\x84\x69\x45\x7b\xa3\xdb\x93\x26\x8a\x0b\xf9\x2c\x26\x55\xd9\x67\x31\xbb\xfa\xb5\xf9\x4a\xc2\x01\x8e\x33\x32\xc1\xc9\x34\x09\x48\x52\x95\x19\x20\x29\xa4\xcc\xd1\x2c\xc6\x91\x14\xad\xa2\x04\xc7\x71\x28\xad\x60\xb8\x4c\x32\xb4\xc2\xa0\x12\x89\xe2\xfe\xcb\xcd\x38\x5a\xa1\x01\x11\xbc\x06\x07\xbb\xa7\xe9\x3b\x78\x20\xf0\x6c\x9a\xa2\x48\x0e\x4d\x6e\x92\xdb\xde\x8d\x76\x9a\x86\x59\xaa\xca\x96\x9a\xef\xcd\x99\x54\xc1\x4b\x3c\xd1\xef\x4d\x5b\x76\x65\x3e\x1d\xa0\xa8\x5a\x64\x9d\x6a\xd9\x5b\x6c\xb4\x56\xaf\xfd\x0c\x3f\x20\xf8\x5d\x96\x0a\xcc\x29\x36\xe5\x47\x5e\x7c\x43\xb5\x2a\xfa\xa6\x8b\x6c\xef\x7d\x55\xe0\xbc\x5b\x42\xde\x25\x2a\xab\x39\x68\x2c\x1b\x4a\xa1\xdd\x5d\x2b\x7c\x01\x4a\x74\xbd\x09\xdd\x4d\xb3\x52\xee\x83\x0f\x43\x6a\xd7\x6a\x93\x79\xa9\x22\x56\xf3\xa4\xf3\x36\x11\xde\xba\x23\xb9\xd9\x40\x8d\xe7\x41\xa6\xbe\x78\xb6\x9c\xfe\x5c\xa4\x9f\x0b\xdd\xa1\xe4\x7c\x30\x54\x13\x9f\x16\xc9\xf7\x5a\x2d\x45\x66\x3a\x30\xe9\xc3\xcc\x14\x91\x79\x1f\x99\xa3\xde\xae\x67\xb2\x68\x15\x7d\x2d\x6e\xdc\xc9\x4a\xc4\x8c\x21\x0a\x36\x0b\x0b\xe3\xc4\xd2\xfa\xbd\x9a\xdb\xd4\x29\x37\x2b\xc8\xb9\x40\x46\x42\x73\xed\xba\x39\xcc\x30\xdd\xfd\xf8\x9b\x2a\x64\x77\xd0\x2f\x74\xfa\x59\xfb\x0e\xfa\x3c\xff\xd7\xf5\x18\x9c\x8c\xbc\xd9\xdb\x75\x51\x37\x47\x67\xc5\xbc\xa4\x8b\x7b\xe7\xc2\xb3\x85\x67\x39\x86\xef\x2a\x5d\xfc\x87\x51\x36\xce\xeb\x7c\xca\x4c\x89\x56\xd7\xa8\x0d\x9a\xd9\xc1\xfc\x79\x3a\x2b\xd9\xf2\x2c\xa7\x17\xe6\x0e\xd5\x47\xa7\xf9\xf2\x68\xb2\x99\xb6\x57\xcf\xd5\x8a\xd5\xaa\x18\xc5\x81\x90\xe7\x5e\x55\x23\xf3\xf1\xa6\xbe\x55\x0b\x8b\x29\x7c\x9f\xf4\x8a\x45\xa6\xf6\xfc\xdc\x15\xad\xf5\xb2\xfa\xf1\xab\xfb\x1d\x48\x85\x20\x21\x49\xa2\x18\x45\x11\x2a\x4d\x02\x9a\x93\x01\x4d\xb0\x38\x49\x71\xac\x4a\x2a\x9c\x8a\x02\x9c\x93\x50\x15\x12\x32\x24\x58\x99\x84\xa4\xc2\xa0\x24\xaa\x00\x55\xc5\x70\x55\x55\xf7\x6f\xb5\xbb\x23\xf2\xe2\x17\x23\x2f\x85\x9d\x79\x69\xe4\xf6\x6e\xb4\xa3\xfe\xde\xc8\x7b\xa6\xcf\x21\xb8\x6e\x58\x9f\x26\x44\xde\x9c\x92\x77\x8b\xf8\x7a\xae\x35\x33\x35\xde\x7d\x7b\x53\x55\x2d\x5b\x7b\xee\xaa\xa3\x5e\xe9\x83\xb3\xf2\x6b\xf7\xa3\x20\x2a\x14\x3b\xcb\xcc\x71\xc9\x68\x14\xcd\xb2\x24\x2d\x21\x98\xbb\x8b\xe6\x7b\x8e\x23\xed\xd6\x04\xac\x32\x25\x27\x2b\xa8\x00\x70\x6f\xd3\xd1\x8a\x19\x2e\x7a\xb3\xe2\xdf\x2b\xf2\xde\x1b\xf9\xee\xf4\xf6\x37\x26\xd3\xc9\x4b\x0f\x8c\xbc\xbf\x72\x9d\x79\x71\xcd\xfb\x0b\x23\x1f\xff\xa0\xc8\xcb\x92\xfb\xf1\x09\xfb\xc5\x73\x91\xd7\x6c\x32\x2d\xd7\x19\x59\x42\xe3\x83\xaf\x82\x37\x93\x20\xf9\x4e\xc3\x28\xe1\xbd\x16\x9b\x01\x3c\x2b\xc9\xeb\xce\x00\xaa\xaf\x0d\xca\x9d\x53\x9d\xf5\x62\x53\xc4\x19\x73\xbe\xb0\x41\xb7\xba\x7a\x87\x15\x74\xd8\x77\x1a\x6b\x86\x6f\x95\xf0\xf9\x3b\xb0\x70\xb9\x8e\x57\x7a\xa3\x5f\x7d\xd6\xcf\xe0\x14\x43\xd1\x12\xa6\x4a\x8a\xca\x12\x12\xca\x62\x38\xa3\x12\x2c\x05\x55\xa8\xa8\x28\x87\x72\xb2\xcc\xe2\xa8\x44\xcb\x32\x64\x30\x15\x93\x51\x96\x63\x14\x8c\x22\x71\x46\x96\x28\xa0\x28\x4f\xbb\x57\x89\xdf\x11\x79\x2f\x96\x66\x28\x0a\x4f\x7e\xf9\x5c\x78\x33\xfa\xdc\xd0\xbd\x71\xf7\xcc\xf9\x7e\x70\xdd\x50\xc7\x4e\x88\xbb\xd9\x29\xa9\x65\x9b\x99\x2c\x2f\x69\x6f\x2a\xf3\x56\xb7\x5c\xe0\x6a\xa3\x6e\x69\x9a\x37\x9c\xba\x9b\x17\x95\x05\x03\x8c\x51\x8b\xca\x14\x66\x9c\x5a\x9c\x3e\x1b\x6b\x61\xa3\xf1\xa3\xfe\xc7\x90\xc9\x54\x87\xd8\x88\x68\x17\x68\x19\x7d\x73\x30\x06\xaf\x4e\xf8\xd9\xec\xbd\xc7\x2e\xd0\xbf\xd7\x8a\xf7\xee\xb8\x77\x6f\xdc\xdd\xd8\xcd\x42\xf5\x81\x71\xf7\x57\xd6\xa3\x7f\x46\xdc\xbd\x35\xee\xf1\x0f\x8a\xbb\xb7\xee\x7e\xc2\xb8\x3b\x7c\x2e\xf3\xdd\xc6\xaa\x59\x24\x2b\xe6\x33\x3d\x7d\xab\xf6\xed\x61\xb1\x97\x25\x57\x94\x94\xb7\x9b\x1f\x03\x00\xf1\x45\xbf\x0b\xd5\xf5\xa8\x31\x58\x5b\x99\x85\xdc\xaa\x59\x7c\xb1\xe7\xe0\xf5\xcc\x06\x17\xfb\x0a\x3a\x81\xa6\x58\xb1\x45\xc8\xe9\x64\xf3\xf5\xb5\x8a\xa9\x15\xe5\x31\x2b\xde\xc3\x67\x15\xa3\xbf\x1d\x1b\xfd\x91\xc3\xc5\x0c\x6e\xb6\xcf\xfc\xe5\xea\x62\xbb\xd3\xe2\xcb\xe2\xd5\xbf\xb9\x1b\xc1\xe8\xff\x46\x33\x9f\xcf\x47\xb0\x1d\x11\x44\x1a\xad\x72\x8d\x6f\x0d\x91\x8a\x30\x44\x3e\xeb\xca\x11\xb7\xf1\x5f\xd0\x8b\x7d\x7e\x10\xd7\x31\xac\xa7\x38\x3f\x45\xf8\x22\xf7\xb1\xdf\x30\x8b\xfd\xe0\xd7\xfe\x75\x1d\x91\xb7\xe2\x1c\xbc\x01\x67\xfc\x10\xe9\x0e\xc9\x9e\x12\xee\x26\xc6\x90\xae\x58\x6e\x76\x05\xe4\xf3\x1e\xfc\x05\xd9\xc3\x6f\xff\x0e\x06\x5c\xa9\x9a\xc7\x4c\xeb\xd5\x82\x5f\x35\xa9\x09\x6f\xfe\xbb\xf0\x76\xbd\xc7\x4a\x76\x9a\xc8\x39\x49\xcf\xb0\x95\x5a\xf2\xc4\x27\xa6\x2f\x3e\x93\xfc\x58\xe9\x93\xc8\x9c\x93\xff\x2c\x6b\x17\x35\x10\x98\xb4\xb4\xf1\xad\x7d\x2b\x48\x59\xcc\x0b\x83\x0b\x32\xe4\x5a\x02\xdf\x11\x02\xd0\x43\x2c\x48\x5d\x8c\x3b\x43\xb7\x5d\x16\x8b\x88\xe4\xda\x10\x46\xbd\x2b\x99\x9b\xc0\xc7\xee\xe7\x27\xc0\x93\x8e\xa3\x04\xbf\x96\x76\xbf\x1b\x79\x33\x3b\x7b\x14\x51\x4e\x0e\x76\x0a\x87\xfc\x04\xc0\x2f\xc8\xf6\x27\x55\xb7\x3f\xd2\x7d\x8a\x39\x15\xc2\xeb\x18\x5c\x58\x8e\xab\xd9\xd0\x39\xc9\x67\x04\x5b\x3a\x5e\x23\x03\xbe\x20\xfd\x92\xd0\x12\x90\x28\x8e\x72\x1b\x11\xeb\x1d\x3f\x87\xff\x7e\xc4\xfa\x04\x38\x93\x07\xf0\xec\xa1\x49\xc7\x6c\xd4\x57\xbc\x51\xa7\xf4\xa9\x9b\x26\xb4\x1f\xc5\xda\x1e\x59\x3a\x06\x03\xf8\x23\x36\x43\xc5\x9e\xbe\x7b\x5e\xc7\xc1\x1b\xce\xef\x31\xdd\x00\x43\x3a\xfe\xc3\x5f\x4d\xde\xda\xeb\x0b\x02\x16\x0b\x43\x97\x83\xf8\x6c\xd9\x4a\x42\xde\x1c\x43\xcf\x59\xfd\xfb\x37\x70\x1a\xa6\xed\x80\xe1\x18\xba\x28\xdb\xdb\xdf\xce\x3a\xe0\xf8\x38\x8d\xe8\xca\x0b\xf2\xc9\x1f\xfc\x29\x89\x59\x5d\x79\x10\x9b\xba\x92\x9a\xc1\xdd\xaf\x83\x2b\x2f\x27\x72\xdf\x45\xa6\xad\xc5\x78\xf1\x28\xbe\x43\x5c\x51\xd6\x13\xd6\x0e\x37\x49\x72\x5a\x00\x77\xfd\x38\x01\x42\x5c\x09\x36\x7d\xa3\x08\x51\x0c\xa7\x84\xb0\x16\x9e\x55\x4e\xac\x9b\x64\x08\x99\xdf\xe3\xb8\x55\xf9\xe7\x15\xed\x6c\x7f\xf7\xdc\x8b\x5d\xf7\xeb\xfa\x10\x5d\x94\xe5\xed\x0f\x2f\x1c\x46\xbf\x93\x1c\x45\xf5\xfa\x28\xb6\x8e\x70\xa6\x0c\xcf\x27\x18\x74\x83\x29\x71\xef\x99\xd6\x3d\x8e\xdb\x4d\xf2\x92\xf9\xb9\xb6\xe2\x11\x91\x80\x73\xe5\x7a\xe1\x24\xc3\xc7\xc8\x62\x9c\x2b\x30\xc6\x67\x14\xf6\x22\x83\xfe\x0b\x5b\x1f\xc3\x9e\x8f\x2a\x15\x73\xdb\xb7\xc4\x26\xb2\xe6\xf3\x0e\xed\x87\xa9\x2f\x86\xef\x12\x93\x31\xf0\x34\x9c\x3e\x46\x8f\x07\xd8\xd2\x72\x79\x51\x9b\x8f\xe1\x2d\x15\x4f\xe7\x79\xd9\x72\x6c\x58\xd6\x6c\xb9\xb8\x8f\xa3\x43\x5c\xa9\x67\x34\xd8\x80\x24\xf0\xb7\x00\xba\x3d\x76\xf5\x39\x7c\x08\x87\x71\x6c\xe9\xfc\x36\x64\xf0\x05\x89\xb3\xfc\x82\x84\x21\x5e\x36\x2c\x07\x2a\x63\xe0\x26\x08\xf1\x80\xb8\x1d\xe2\xb9\xc4\xf1\x95\xab\x23\x0f\xeb\xc3\xb4\x7b\x85\x62\x2f\xea\x4d\x37\x15\xb8\x1e\xc7\x96\x1c\xce\xd8\x32\xc7\x40\x51\x6c\xe8\x38\xf7\x2a\xf4\x22\x81\x83\x8d\x73\x78\x3b\xb6\x55\x0d\x00\xaf\xe0\xfd\x7e\x3b\x38\x87\xfb\x32\xc7\x27\xbc\xec\x10\x61\xb8\x0a\xf7\xf0\xb9\x9b\xc5\xed\x45\x91\xb3\x58\x2f\x2e\xfb\x3d\xa0\x0b\x8c\x86\x6b\x28\x0f\xe5\xce\x88\x1e\xc4\xed\x29\xd4\x17\x97\x6f\x69\x2d\x39\x82\xfc\xd1\xc6\x70\x80\xfa\x96\xf5\x66\x32\xba\xf9\xc2\xb2\xbd\xc0\xf7\x0e\x6d\x47\xb7\xcc\xc7\x2b\x3a\x4e\xe1\x32\xfb\xb1\x01\xe9\x85\x09\x43\x4f\xfa\x22\xc7\x0d\xfa\x8f\xd0\xb8\x28\x49\x04\x36\xbd\x10\x0b\x1b\xbe\xeb\xd6\xd2\xf9\x25\xd2\x9c\x22\x76\x51\xac\x53\x83\xd2\xcb\xb7\x2d\xa2\xfc\x34\x99\xb6\x04\x2e\xca\x91\x58\x7e\x3c\x44\xbd\x7f\xd5\xf4\xcf\x70\xed\x38\xf6\x93\x1b\xe0\x6b\x1d\xfc\x10\xe9\xe1\x16\xea\x41\x1e\x7e\x8e\x44\x1a\x19\x2e\xec\xeb\xce\x12\x7b\x5c\xfa\x3a\x46\x9c\x8a\xf7\xcb\x49\x2c\xba\xd9\xfe\x19\x66\x73\x8c\xff\xe6\xad\xbe\xbf\x88\xdb\x25\xf2\x6d\x85\x71\x2c\x59\xd6\xec\x66\x2d\x9f\xc1\x79\x71\x89\xf0\xf9\xb3\x02\x5d\xa0\x1b\x0e\xf2\xf5\xdf\xff\x46\x9e\x1c\xcb\x50\x22\xc7\x9b\x4f\xdf\xbf\xbb\x70\xed\x7e\xf9\xf2\x82\x24\x03\xca\x96\x92\x0e\x30\x38\x1c\x49\x06\x95\xac\xa5\x36\x71\x53\x91\x3f\x00\x3d\xcf\xc0\x01\x68\x8c\x85\x6d\x51\xdc\x37\x32\xe4\x07\x42\x10\xa9\x3b\x03\x74\x65\xac\x46\xce\xed\x0a\x95\x5f\xd3\x1f\x10\x92\x45\x0a\xf5\x96\x50\x2e\x8a\xbb\x33\x39\xa4\x25\x14\x84\x96\x20\xe6\x84\x76\xec\x98\xca\xbf\x5b\x17\x91\x6e\x23\xef\x99\x4c\x4b\x68\x77\x5a\xe5\x5c\xc7\xfb\x2a\x2f\x54\x85\x8e\x80\xe4\xf8\x76\x8e\xcf\x0b\x67\x0e\x36\xbd\x7d\xc7\xe1\xc7\x71\xac\x14\xf3\x38\x65\x1c\xd2\xb9\x70\x6a\x99\xc4\xc9\xa1\x7e\xe2\x65\xa3\x93\xca\x0a\x17\xfa\x17\x8e\x78\x13\x35\x11\x6e\x65\xff\x72\x3d\x44\xf9\x38\xa5\x85\x6d\x95\xe0\xbc\xc1\x5c\xa7\x81\xe3\xa2\xd2\x5f\xa8\x86\x04\x66\x0e\x75\x71\xa2\x0c\xf6\x58\xa3\x88\x97\x38\xfe\x0e\x0a\x49\x36\x8d\xa3\x1a\x52\x1a\xeb\x40\x80\xa2\x40\x05\x99\x03\x73\x09\x0c\x63\x73\xc0\x69\xb9\x80\x08\x83\x72\xbb\xd3\x0e\x78\x0e\x24\xfb\x36\x83\x9b\xf1\x3b\x30\x96\x70\xec\x61\x84\x48\xbe\x55\x6f\x44\x19\xdf\x8f\x8a\x41\x06\x2d\x12\xbf\xf9\xf0\x71\x02\xa7\x71\xff\xbe\x4d\x91\x01\x78\x9c\xf2\x67\x5f\x6f\x67\x2f\x4f\x49\xf2\x04\xd8\x40\x76\xa1\x8d\xbc\x03\x7b\xa3\x9b\xda\x67\x9c\xa2\xbe\xec\x4e\x4a\x5f\x2e\x63\xf1\x89\x5e\xc2\xf3\x5b\xac\x0f\x38\xce\xed\xae\x05\x18\xae\x17\x63\xdd\xd4\xa0\xe3\x8e\x0d\xe0\xfd\xe7\xaf\xb4\x9f\x5e\x90\x27\xf4\xe9\xcb\xef\xc7\xb6\x12\x43\x74\xca\x58\x4e\x69\xfa\xb0\xe3\x63\x06\x37\xde\x8c\x1f\xe8\x73\x57\x30\x71\x74\xcd\xf4\xd6\xfa\x29\x14\xba\x1d\x74\x42\x1b\x34\xf9\x25\x85\x2e\x91\x80\x18\xe2\xe5\xee\x34\xe0\x2b\xa8\x6b\x13\x17\xd1\x4d\x17\x6a\xd0\x8e\xcd\xda\xd7\xaf\xc8\x0a\x22\x2b\xdd\x30\x90\xb7\x25\xb4\x37\x88\xb4\xd9\xe2\x77\x2c\xc4\x9d\x00\x17\xd1\x1d\x64\x35\xd9\x7d\xab\x3b\x88\x3b\x81\x88\xaa\xdb\x8e\x8b\xe8\x2e\x9c\x23\xba\xe9\x7f\x23\x5b\xf3\x85\xe5\xe8\x2e\xf4\x74\x99\x82\xad\x03\xe5\x06\xc8\x77\x5d\x1a\x5f\x7e\x8b\x4d\xe3\xc9\x45\xa6\x37\x85\xdb\xc8\x35\x5f\xae\xa1\xe2\x29\xd2\xd3\xea\x67\x9a\xfb\x12\xf6\x3a\x7a\x30\x91\x26\x8a\x04\xb8\xd3\xc4\x22\x4b\x71\x0f\x8d\x63\x2d\x6d\xf9\x36\x4c\xdb\x35\xa7\xcf\x71\x50\xe6\x4b\x1c\x1f\x46\xd7\x46\xd0\x0b\xd1\x6e\x56\x11\x05\xb8\xc0\xcb\x5a\x88\xb2\x9c\x2f\x7c\x3d\x1b\xd0\x85\x7e\x58\xfc\x7f\x01\x00\x00\xff\xff\x81\x57\x47\x8f\x64\xd8\x00\x00") +var _failed_transactionsHorizonSql = []byte("\x1f\x8b\x08\x00\x00\x00\x00\x00\x00\xff\xec\xbd\x79\x8f\xa2\xca\xfa\x38\xfe\xff\xbc\x0a\x32\xb9\x49\xcf\x7c\xbb\x67\x64\x5f\xfa\x7c\xe6\x26\xb8\xdb\x2a\xee\xda\xf6\xc9\x89\x29\xa0\x40\x5a\x16\x1b\xb0\xd5\x3e\xb9\xef\xfd\x17\x16\x15\x11\x14\x97\x99\x33\xf7\xe6\x47\x26\x93\x56\xaa\x9e\xad\x9e\xad\x9e\x7a\x90\x6f\xdf\x3e\x7d\xfb\x86\xb4\x2d\xc7\x55\x6d\xd8\xeb\x34\x10\x19\xb8\x40\x04\x0e\x44\xe4\x85\x31\xff\xf4\xed\xdb\x27\xef\x7e\x71\x61\xcc\xa1\x8c\x28\xb6\x65\xec\x06\xbc\x43\xdb\xd1\x2c\x13\xe1\xbe\xd3\xdf\xb1\xc8\x28\x71\x8d\xcc\xd5\x89\x37\x3d\x36\xe4\x53\xaf\xd4\x47\x1c\x17\xb8\xd0\x80\xa6\x3b\x71\x35\x03\x5a\x0b\x17\xf9\x81\xa0\x7f\xf8\xb7\x74\x4b\x9a\x1d\x7e\x2b\xe9\x9a\x37\x1a\x9a\x92\x25\x6b\xa6\x8a\xfc\x40\xee\x06\xfd\x32\x7b\xf7\xc7\x06\x9c\x29\x03\x5b\x9e\x48\x96\xa9\x58\xb6\xa1\x99\xea\xc4\x71\x6d\xcd\x54\x1d\xe4\x07\x62\x99\x21\x8c\x29\x94\x66\x13\x65\x61\x4a\xae\x66\x99\x13\xd1\x92\x35\xe8\xdd\x57\x80\xee\xc0\x3d\x34\x86\x66\x4e\x0c\xe8\x38\x40\xf5\x07\x2c\x81\x6d\x6a\xa6\xfa\x47\x48\x3b\x04\xb6\x34\x9d\xcc\x81\x3b\x45\x7e\x20\xf3\x85\xa8\x6b\xd2\x83\xc7\xac\x04\x5c\xa0\x5b\xde\x30\xbe\xd1\x2f\x75\x91\x3e\x9f\x6f\x94\x90\x5a\x19\x29\x3d\xd7\x7a\xfd\x1e\xd2\x12\x1a\xe3\x70\xfc\xf7\xa9\xe6\xb8\x96\xbd\x9e\xb8\x36\x90\xa1\x83\x14\xbb\xad\x36\x52\x68\x09\xbd\x7e\x97\xaf\x09\xfd\xc8\xa4\xfd\x81\x13\xc9\x5a\x98\x2e\xb4\x27\xc0\x71\xa0\x3b\xd1\xe4\x89\x32\x83\xeb\x3f\x7e\x05\x42\xc9\xff\xeb\x57\xa0\xf4\xf4\xea\xd7\x31\x18\x60\x3b\x9f\xbb\x80\x40\x4f\x91\x8f\x21\x8b\x8c\xda\x01\xf7\x87\xd7\x84\x62\xe9\x39\x32\x32\x04\xeb\x53\x35\x81\x8a\x02\x25\xd7\x99\x88\xeb\x89\x65\xcb\xd0\x9e\x88\x96\x35\x3b\x3e\x51\x33\x65\xb8\x9a\x44\x98\x33\x1d\xe0\x2b\xba\x33\xb1\xcc\x89\x26\x9f\x33\xdb\x9a\x43\x1b\x6c\xe7\xba\xeb\x39\xbc\x62\xf6\x8e\x92\xab\xa8\x38\x6f\xae\x0e\x65\x15\xda\xfe\x44\x07\xbe\x2d\xa0\x29\x9d\xc5\x42\x64\xfa\xdc\x86\xef\x9a\xb5\x70\xc2\xef\x26\x53\xe0\x4c\x2f\x04\x75\x3d\x04\xcd\x98\x5b\xb6\x67\x8e\xa1\x4f\xbd\x14\xcc\xa5\xb2\x94\x74\xcb\x81\xf2\x04\xb8\xe7\xcc\xdf\x28\xf3\x05\xaa\x14\xda\xe5\x05\x44\x47\x67\x02\x59\xb6\xa1\xe3\x1c\x9f\x3e\x75\x6d\xd9\x8f\x3b\x13\xdd\xb2\x66\x8b\x79\x86\xd1\xf3\x53\x24\x05\xa3\x80\x66\x9f\x09\x78\xe3\x74\x33\x4f\xf0\xfc\x84\xa2\x40\x3b\xdb\xd0\x0d\xf8\x0b\xa6\x84\x62\xcd\x36\xc9\x77\xad\x67\x20\x89\xba\xe2\x53\x33\xe6\xde\x84\xa9\x7b\x72\x05\x9c\x3d\x07\x24\xae\x4f\xaa\xd1\x74\x6b\xe9\x59\x06\x5b\x01\x1d\xd6\xc9\x81\x9a\xe3\x4e\xdc\xd5\x64\x7e\x1a\xa4\x37\xd2\x9a\x67\x1d\x09\xb3\x0e\xdb\x84\x92\xe3\x83\xc5\x8d\xb9\x9f\x1c\x76\xda\x8b\x89\xeb\x6c\x8b\x19\xc4\x48\x4f\xda\x8e\xb3\x38\x85\x79\x3b\x58\xb2\x64\x78\x66\x5e\xb0\x55\x83\x39\xb0\x5d\x4d\xd2\xe6\xc0\x3c\x1a\xbc\x4f\x4d\x9d\xcc\xcf\xcc\x4d\xb6\x11\xed\x5c\x0a\x92\x27\x9e\x8d\xdf\x17\x5e\x16\x7c\xc1\xc0\x9f\x0e\x3f\x58\x4c\x6f\x25\xc3\x3f\xbd\xf8\xb0\x49\xfd\x7c\x65\x98\x64\xa4\x40\xb5\xec\xf9\xc4\xd0\xd4\x30\x61\x38\x42\x42\x6c\x64\x66\x1e\xcf\xcf\xf7\x8e\x41\xce\xaa\x9c\xc1\xec\x42\xab\x31\x68\x0a\x88\x26\x07\x98\x8b\xa5\x32\x3f\x68\xf4\x33\xc2\x4e\x51\xba\x1b\x40\x0e\x97\xfb\x38\x24\xff\x53\x76\xf6\x37\x51\xba\x57\xea\x0c\x4a\x42\xe1\x02\x99\x79\x79\xb6\x03\xdf\xce\xc6\xbc\x07\x24\xf3\x6c\x19\x66\x1c\xbb\xcb\x66\x33\x73\x98\x62\xf5\xe7\xf0\x97\x0c\x22\xdb\xdc\x30\xef\xcb\x36\x38\x4c\xf2\x32\xf3\x16\x7a\x80\x73\x78\x09\xa6\x64\x1c\x1b\xa6\x7f\xd9\xe9\xd9\xe4\x8b\x59\x28\x8a\xf9\x90\xe3\x83\x23\x2e\x21\x1c\xc8\x57\x2a\xdd\x52\x85\xef\x27\x0c\x36\x34\x6f\xc7\xa1\x49\xf0\x8b\xb9\x30\xa0\xad\x49\x7f\xfe\xf5\x35\xc3\x2c\xb0\xba\x60\x96\x0e\x1c\xf7\x0b\x30\xd7\x50\xf7\x4b\x31\x19\x66\x28\x9a\x9d\x38\xa5\x3c\x10\x0a\xfd\x5a\x4b\x38\xc2\xcf\x04\xa8\xea\x8e\xba\x07\xe4\x80\xd0\x23\x30\x36\xdc\x5d\x01\xc3\xe3\xd5\x9f\xbe\x23\xfe\x01\x39\x87\x11\x9f\xf5\x0c\x10\x4a\xcf\xfd\x92\xd0\x8b\x81\xd0\xe7\xaa\xf3\xa6\x6f\x74\xb1\x50\x2d\x35\xf9\x03\x0c\x7f\x7c\x0a\xaa\x70\x02\x30\xe0\xe3\xe6\x3b\xa4\xbf\x9e\xc3\xc7\x70\xca\x1f\x48\x4f\x9a\x42\x03\x3c\x22\xdf\xfe\x40\x5a\x4b\x13\xda\x8f\xc8\x37\xbf\x38\x57\xe8\x96\xbc\xf5\x0a\x21\x6f\xe0\x7d\xda\x83\xb8\x7f\x33\x04\x5c\x68\x35\x9b\x25\xa1\x7f\x04\x72\x30\x00\x69\x09\xfb\x00\x90\x5a\x0f\xb9\xdb\x94\xdd\x36\xdf\x39\x3e\x90\xbb\x38\xe6\x0d\xfb\x21\xce\xad\x84\x4e\xf2\xb3\x27\x4b\xa1\xd5\x8f\xc9\x13\x19\xd5\xfa\xd5\x2d\x59\xd1\xfa\xdb\x1e\xfa\x1d\x94\x18\x21\xe7\x30\x7f\x00\xc4\x17\x40\xbb\x91\x9b\xab\xbd\x4e\x03\x99\xdb\x96\x04\xe5\x85\x0d\x74\x44\x07\xa6\xba\x00\x2a\xf4\xc5\x90\xb1\x5e\x18\x25\xf7\xb4\xa2\x85\xe4\x6f\x74\x75\x47\xff\x66\x6d\x93\x64\xb9\xd5\xec\x93\xf0\x91\x6e\xa9\x3f\xe8\x0a\xbd\xc8\x77\x9f\x10\x04\x41\x1a\xbc\x50\x19\xf0\x95\x12\xe2\x73\xdf\x6c\x0e\x02\x7f\xd7\xeb\x77\x6b\x85\xbe\x3f\x82\xef\x21\xff\x9a\xfc\x0b\xe9\x95\x1a\xa5\x42\x1f\xf9\x17\xe6\x7d\x8a\xaf\xc6\x49\x43\xbc\x8e\xbb\x53\xe0\x6f\xc6\x1c\x9e\xc4\x5c\x16\x4f\x75\x1d\x7f\x19\x30\x6c\x59\xdc\x7e\x75\x11\x87\x5f\x3e\x21\x48\x81\xef\x95\x90\x51\xb5\x24\x20\xff\xc2\xfe\xc4\xfe\xca\xfd\x0b\xfb\x13\xff\xeb\xdf\xff\xc2\xfd\xbf\xf1\x3f\xf1\xbf\x90\x7e\x70\x13\x29\x35\x7a\x25\x4f\x28\x25\xa1\xf8\x35\x51\x32\x19\xe2\xc0\x95\x92\x39\x8d\xe1\x67\x4b\xe6\xff\x2e\x91\xcc\x61\x4c\x0d\xe5\xb0\x8d\xc3\xd9\x04\xb1\x0b\xdb\x07\x10\x7d\x8a\x11\xa4\xe7\xc9\x0a\xf9\xb1\xf3\x00\x0f\xc1\xd7\xfd\x71\xbb\x84\xfc\x88\x5a\xc4\xd7\x24\xab\xbd\x29\x8d\x71\x80\x31\x12\x37\x66\x9c\x9d\xc2\xc4\x14\xe8\x5a\x2a\x93\x80\xc6\x28\xdd\x33\xc8\x7d\x72\x77\x5a\x76\x48\x6d\x52\x9a\x77\x35\xb5\x09\x40\xe3\xd4\x46\x8d\xe4\x28\xb5\x5e\xe4\x92\xa1\x02\x16\xba\x3b\x71\x81\xa8\x43\x67\x0e\x24\x88\xfc\x40\xee\xee\xfe\xd8\xbf\xbb\xd4\xdc\xe9\xc4\xd2\xe4\xc8\x51\xda\x1e\xaf\xd1\xfc\x37\x64\xd1\x37\xb0\x6c\xec\x05\xb6\x18\xdd\x7c\x07\x1c\x69\x32\x22\x6a\xaa\x66\xba\x7e\x62\x20\x0c\x1a\x8d\x80\x1d\x60\x78\x69\x3c\x22\x4d\x81\x0d\x24\x17\xda\xc8\x3b\xb0\xd7\x9a\xa9\xc6\x86\x99\x0b\x63\x9b\xf2\x23\x9a\xe9\x42\x15\xda\xb1\x21\x8a\x0e\x54\x07\x71\x0c\xa0\xeb\x87\x68\x5c\xcb\xd0\x0f\x91\x7c\xc1\x29\xea\xeb\x76\xe4\xe1\xb2\xc7\xf7\x0d\x97\x8a\x23\x5e\xed\xd8\x8a\xc4\x85\xab\x03\x81\xcc\xe7\xba\xe6\xd7\xec\x11\x57\x33\xa0\xe3\x02\x63\x8e\x78\x6b\xe6\x7f\x44\x3e\x2c\x13\x1e\x12\x9a\xb6\x2b\xda\xe4\xa3\xe1\x76\x2a\x1b\xcd\xdb\xcd\x57\x0a\xd4\x50\x0d\xf9\x6e\x3f\xc8\xe8\x30\xff\x8b\x9a\x50\xe8\x96\xfc\xf4\x2b\x3f\x0e\xbf\x12\x5a\x48\xb3\x26\x0c\xf9\xc6\xa0\xb4\xfd\xcc\x3f\xef\x3e\x17\xf8\x42\xb5\x84\x60\xa7\x98\xb9\x58\xec\x71\x40\x07\xaa\x18\x16\x3d\x10\x13\xae\xdc\x77\xa0\x7f\xb9\x4b\xe1\xf8\xee\xf1\xd1\x86\xaa\xa4\x03\xc7\xf9\x1a\x5f\xae\xe0\xac\x22\x41\xb7\x68\xf2\xeb\x91\x85\x0a\xf6\xc6\x57\x73\x16\x54\x74\xb6\x7c\x25\x5b\xc6\xae\x56\x97\x4c\x66\xe2\x70\xc9\x92\x93\x86\x63\x78\xf2\xf0\xa0\xfc\x97\x30\x81\xa2\x8f\x59\x58\x72\x79\xe1\x46\x6a\x1b\x85\xf9\xcb\x94\xf6\x18\x23\x48\x6b\x24\x94\x8a\x48\x7e\x7c\x82\xa3\xa0\x42\x77\x9c\xa1\x2d\xac\xd8\xed\xef\x9a\x9c\x46\xdb\xa6\xe6\x73\xad\xd6\x85\x70\x42\xb5\x8b\xd9\xcc\x24\xcd\xd3\x1f\x96\xb8\xd2\x46\x7e\xf6\x0f\x3e\x3e\xa7\x68\xb3\xaf\xc7\xc9\xb7\x64\xe8\x02\x4d\x77\x90\x57\xc7\x32\xc5\x74\x65\xdb\x14\xca\xae\x95\x43\x08\x27\x94\xc3\xe6\xdc\x3a\x85\xb6\xc8\x61\x72\x26\x2b\x4c\x3a\xc7\x4e\x9e\x18\x8a\x25\x52\x19\xf5\x17\x62\x4b\xc7\xc6\xcb\xa1\x31\x0c\xbb\x85\xc8\x36\x7e\x7b\x98\x1c\x0b\x4c\xd6\xc2\xdd\xc5\xa6\xf8\x1c\x1b\x02\xf7\xe4\xa4\x60\xec\x62\x2e\x67\x1e\xbb\x55\x9d\xf0\x63\xec\x9c\xfd\x80\x17\xec\x20\x1f\x70\x81\x3e\x91\x2c\xcd\x74\x92\x75\x50\x81\x70\x32\xb7\x2c\x3d\xf9\xae\x7f\xf2\xa9\xc0\xb4\xb5\xf6\x6f\xdb\xd0\x81\xf6\x7b\xda\x10\x2f\x0f\x75\x57\x13\x3f\x4d\xd2\x3e\xd2\x46\xcd\x6d\xcb\xb5\x24\x4b\x4f\xe5\x2b\xbe\x46\x1b\x65\x81\x40\x86\xb6\x9f\x5e\x04\xdf\x3b\x0b\x49\x82\x8e\xa3\x2c\xf4\x49\xaa\xa2\x84\x8c\x03\x4d\x87\xf2\xa9\x51\x21\xe9\x29\x2a\x94\x6e\x7a\x29\xf5\xed\x6b\x2d\x31\xe5\xcc\xe4\x44\x5c\xcc\xee\x91\x4e\xfb\xb8\x73\x59\xbe\x6d\xa8\x3b\x8a\xe3\x57\x85\xbe\xb3\x18\xbd\x32\x14\x1e\xc5\x75\x18\x1a\x93\x87\x1f\x09\x95\x91\xd3\x9f\x9b\xe9\xe6\xa9\xad\xd0\x7e\xe7\x55\xca\x76\xc9\xdb\x1d\x48\x01\x2b\x7e\x94\xbc\x32\x48\x86\xde\xc1\x5a\xd8\xd2\xb6\x95\x23\x25\x3c\x6d\x5c\xce\xdd\xdd\xe3\x63\xfa\x76\x2d\xdd\x0e\xc2\xc3\xb7\x6b\xc5\x19\xf6\x0b\x7e\xb9\x69\x4e\x11\xba\xcd\x4b\x22\x9c\xdf\x2f\x93\x8a\x36\xd6\xad\x78\x6c\x50\xd8\x40\x79\x6c\x48\xb0\x57\x4e\x1c\x70\xd8\xf7\x79\x62\xdc\x51\x74\xdb\x51\x47\x30\xfa\x24\x69\xce\xc4\x81\xba\x0e\x6d\x44\xb4\x2c\x1d\x02\x73\x13\xb7\x34\x09\x4e\xcc\xbd\x18\x1d\x7c\xb7\x1f\xb7\x77\x1d\x47\x93\x58\x44\xdf\xeb\x79\x8a\xdf\xb4\xad\x85\x29\xfb\x4d\xc3\xba\x36\x9f\x03\x15\x1e\x02\xd5\x9c\x09\x5c\x01\xc9\xdd\xa7\x2b\xd2\x03\x90\xd8\x56\xea\xb3\x3b\xf1\x1b\x8f\x91\x42\xb5\x54\xa8\x23\x5f\xbe\x44\x45\xff\x6f\x04\xfd\xfa\xf5\x14\xa8\xa4\xe9\x1b\x69\xff\xdf\xc1\x02\x64\x80\xb7\xb7\x18\x31\xf0\xb1\x95\xf2\x09\x3c\x6a\x83\xc9\xc7\xe7\x37\xb0\xca\xe4\x86\x88\x8c\x21\x38\x8b\xef\xbb\x26\x08\x9f\x6a\x3e\xb8\x4d\x18\x3e\x81\xe5\x57\x05\xe2\x33\x99\xbd\x32\x14\x9f\xc0\x76\x18\x8c\xd3\x26\x1c\x09\xc7\x7b\x0d\x27\x37\xd4\xd5\x8d\x7e\x46\x49\xca\xbc\x43\x0b\x83\xc6\x89\x7d\x5f\xd6\x88\x7d\x3c\xf8\x26\x8e\xdd\xa1\x4e\xb4\x17\x6f\x8b\x91\xbe\x47\x49\xdb\xfd\xfd\x23\xfb\x37\x77\x35\x81\xe6\x3b\xd4\xad\x39\x4c\xaa\x89\xba\x2b\x6f\x37\xb5\xd0\xdd\x94\x9b\x06\x74\x41\xca\x2d\x6f\x1f\x97\x76\xdb\xd1\x54\x13\xb8\x0b\x1b\x26\x95\xef\x38\xfa\xeb\x9f\x7f\xed\x92\x9e\xbf\xff\x93\x94\xf6\xfc\xf9\x57\x5c\xe6\xd0\xb0\x52\x2a\x6d\x3b\x58\xa6\x65\xc2\xa3\x49\xd4\x0e\xd6\x21\x98\x90\x33\xcd\x80\x13\xd1\x0b\x83\x7e\x39\x9c\xb5\x81\xa9\xc2\x3d\xb5\x4c\xbe\x69\x68\xe6\x24\x45\x7b\xd2\x07\x4c\xe2\x11\x36\x71\x50\x88\x57\x05\xf3\xbd\xb1\x70\xe5\xda\x60\xe2\x89\x1a\xda\x8e\xbf\x0a\x7f\xfe\x15\xdf\x93\xee\x07\x69\x6f\xc9\x3c\xb6\x55\x18\xdb\xe4\x9b\x26\xb4\x27\xd9\x4c\x75\x07\xe9\xa8\x5d\x45\x01\x9f\xd6\x86\xf0\x28\x02\x2e\x27\x1b\xd3\x0a\xc8\x3b\x55\xd6\x44\x34\x79\xe3\xb4\x36\x6d\x76\x59\x3c\x6d\xe0\xb5\xfc\x9e\xc6\x13\x1d\x7c\xbd\x52\xff\x48\x2d\x3b\x5a\x35\x8c\x56\xb2\xcf\xdb\xc7\xdd\x8e\x89\x8c\x0d\x8e\x47\x99\x3a\xba\xff\xcb\xc2\x64\x6a\xc2\x72\x33\x36\x33\xf7\x88\x1e\x65\xf4\x44\x74\x4d\x66\xb5\x08\x5c\x80\x28\x96\x7d\xe2\x44\x0f\x29\xf2\x7d\xfe\x04\x7b\x35\xa1\x57\xea\xf6\x91\x9a\xd0\x6f\xed\x9d\xea\xf9\xc9\x48\x0f\xf9\x82\x3d\x20\x77\x38\xba\xb9\xee\x1e\x10\xfc\x01\x41\x1f\x90\xbb\xbb\x74\x72\x8e\x9d\xaa\x9d\x4b\x52\xfc\x64\x6d\x43\xd6\x1d\x36\xd1\x4c\xcd\xd5\x80\x3e\x09\xba\x9c\xbe\x3b\x6f\xfa\x9d\x4f\x2b\xc6\x7d\x43\xe9\x6f\x28\x81\x60\xec\x23\xce\x3e\x92\xcc\x77\x94\xc0\x49\x8e\xbe\x47\x71\x8f\xe8\x4c\xd0\xf1\x49\xf0\xf4\xca\xde\x8a\x88\xeb\x89\x6b\x69\xf2\x71\x4c\x1c\x4d\x31\xe7\x60\x22\x26\x0b\x07\xee\x9c\xac\x66\x1e\x3c\x31\x73\x14\x1f\x49\xa2\x24\x7b\x0e\x3e\x72\x02\x64\x79\x12\xaf\x3b\x1e\xc5\x41\x91\x14\x81\x9f\x83\x83\x9a\x04\x69\xc5\x66\x83\xe3\x9f\x57\x1f\x45\x41\x13\x28\x7e\x16\x1b\xf4\x06\x45\xe8\xfd\x32\xa0\x60\x49\x8c\x3a\x07\x05\x33\x31\x2c\x59\x53\xd6\xd9\xb9\x60\x31\x1a\x3f\x0b\x05\xbb\xc7\x45\xd8\xa6\x9e\x01\x0f\x43\xd2\xc4\x79\x78\xbc\x45\x07\xaa\x6a\x43\x15\xb8\x96\x7d\x5c\xa7\x38\x14\x43\xb9\x73\xc0\x73\x3e\xf8\xa0\x26\x3d\x59\xc9\xf6\x71\xe8\x38\x83\x9d\xb5\xd4\x18\xea\x83\x0f\x57\xc1\xaf\x32\x1c\x47\x40\x71\xcc\x59\xd2\xc1\xb0\x28\x82\xed\xee\xd3\x73\x00\xc7\x11\x71\x34\x77\x1e\x27\xf8\xde\x42\x87\xfb\xfd\xe0\xc1\xe8\x63\x98\x30\x94\xa1\xc8\xb3\x56\x04\x23\x02\x76\xb6\xe5\x95\xa3\x2b\x8e\x61\x38\x43\x9f\xc7\x09\x39\x51\xb4\xd5\xe6\x21\x11\xcb\xd0\x27\x8a\x06\xf5\xa3\xae\x11\xc3\x28\x0c\x3b\xcb\x09\x63\xd4\x26\xe7\xdc\x9c\x59\xac\x4e\xb0\x41\x33\xe7\xb9\x79\x8c\x9e\x68\xa6\x0a\x1d\x77\x72\x78\x2a\x72\x02\x15\xc3\xb1\xe7\xad\x08\xb3\x17\xea\xfd\xe3\x27\x70\x3c\x98\x60\x38\x8a\x12\xe4\x59\x48\xd8\xad\xfa\x2a\x96\xbd\x49\xca\xf7\x70\x60\xe8\x37\x02\x43\x30\xf2\x11\xe3\x1e\x49\xee\x3b\x86\x13\x2c\x41\xdd\xa3\x58\xf6\xd0\x48\x26\x47\xa6\xab\x01\x13\xa4\x2f\x15\x71\x61\xcc\xd3\xd7\xe1\x7a\x2c\x4c\x60\xec\x89\xe7\x5b\x13\xd7\xda\x1c\xfa\xde\x16\x2b\x49\xfb\x58\x8d\xc5\xca\xdb\x3f\xff\x14\xf1\x51\x44\xd4\x8b\x1d\x54\x50\x6f\x8c\x8c\xf4\x1f\x9e\xb4\xa1\x64\x99\xb2\x16\x3c\xb8\x05\x4c\x79\xa7\x7d\x9e\x37\xb8\x35\x83\xd4\x44\xd1\x74\x17\xda\x13\x7b\xa1\xc3\xec\xc0\x93\x93\xd4\xa3\x4d\x48\xe7\x66\xa9\x07\x8d\x48\xd1\xec\xb9\x92\x7f\xae\x74\x9e\x46\xc3\xc6\xa8\x35\xae\x96\x1b\xc3\x7e\x7d\x34\xa4\xca\x95\x2a\x4f\x34\x84\xf1\x18\x7f\xea\xd4\x9b\x4c\x8b\x7f\xe2\x07\xa5\x4e\x79\x40\x37\xda\x85\x5e\xa9\x3c\x7c\x6e\x09\x71\xc1\xa4\x22\xc1\x3d\x24\x3c\x35\xca\xb7\xc7\x3c\x35\x26\x47\x7c\xa9\xfa\x3c\xea\xe2\x83\x7a\x0b\x1f\xb4\xc8\xfc\xa0\x52\x1d\x74\x18\xb2\x34\x68\xd7\x5b\x02\xde\xa9\x0e\xc9\x51\xb7\xda\xaa\x75\x85\x7a\xbd\x7a\xe0\x5a\x52\x91\x10\x1e\x92\xc2\x73\xbd\x42\x77\x05\xb2\x25\xd4\x4a\xed\x42\x53\x28\xe7\x19\x02\xe7\x49\x82\x7e\xa1\xda\x42\xb1\xd7\x6d\x54\x46\x75\xa6\x92\x6f\x14\x9a\x9d\x46\xad\xdc\x22\x7b\x4c\x69\x3c\x1a\x0e\x32\x23\x21\x7d\x71\x75\xdb\xe3\x6a\xad\x81\x17\x6a\x44\x59\xe8\x90\xf9\xe7\x46\xb9\x29\x14\x1b\xe5\xa7\x81\xd0\x1e\xe0\xd5\x31\xf1\xd2\x2c\xf7\xaa\x2d\x61\x50\x28\xb5\xf8\xde\x88\xe9\x14\x98\xd6\x33\x5e\xbd\xbb\xb4\x69\xce\xdb\x9f\x9d\x58\xeb\xb0\xd1\x78\xf7\x8c\xc0\x77\x07\x1e\x6f\x28\x7b\x40\xc8\x07\xc4\xb5\x17\x30\x7d\x9b\x74\xa4\x55\xec\x62\xfd\x0b\xca\x07\x51\xed\x93\x6c\x28\x6b\xee\x04\xe8\xf3\x29\x30\x17\x06\xe9\x99\xcc\xa0\x57\xbc\xbb\x72\x39\x2f\x69\x8e\xba\x89\x9c\xf7\x8a\x1d\x0f\x08\x96\x55\xca\x49\xbd\x51\x97\x8a\x79\xd3\x1f\x15\x91\x33\xc6\x78\x19\x01\x43\xe0\x2c\xe6\x13\xe5\xd9\xe4\xdf\x9f\x83\x0c\xef\xf3\x23\xf2\x19\x43\xd1\xef\xe1\x1e\xfa\xf3\x03\xf2\x79\xd7\x82\xe7\xdd\x1c\xf4\x8a\xbb\x2f\xdd\xf5\xdc\xff\x32\xbe\x70\xbb\x11\x41\x2b\x9e\x37\xe6\xd2\x15\xfc\xfc\x9f\x34\x93\x8c\xb3\x46\xc4\x58\xc3\x1f\x10\xe2\x7f\x84\x35\x7c\xcb\x1a\x43\x30\xcc\xff\xe8\xaa\x05\xac\xfd\x8f\xad\x1a\xce\xb2\x24\x87\x52\x1c\x4b\x05\xab\x86\xfa\xbc\xe9\x9a\xa1\xf9\xac\x71\x38\x4e\x10\x0c\x8e\x12\x34\x4b\x7d\x27\x19\x86\x62\x51\xe6\xbf\x8a\x47\x6c\xc3\x23\x86\xa2\x1b\x7f\xf2\xbf\xc6\x23\xf1\x80\xb0\x14\xcb\x71\x04\x4b\xb3\x9c\xcf\x62\xc0\xa1\xe3\x02\xdb\xf5\x12\x57\x11\xe8\xc0\x94\x60\xa8\xab\x3b\x65\xcd\x8c\x81\xdc\xc7\x90\x6c\x03\x09\x46\xb0\x91\x93\x09\x5c\xed\x1d\x5e\xcc\x91\x67\x83\x01\x4b\x4b\xa8\xa9\x53\x0f\x21\xf6\x80\x7c\x0e\x82\xcc\x64\x06\xd7\xbf\x4c\x97\x7c\xaa\x48\x9c\x09\xcd\xe5\x67\xc9\x39\xc4\xf0\xd3\xe5\x1c\xe3\x28\x9b\x9c\x2f\xcc\xc1\xcf\xf2\x4b\x01\x55\x34\x1b\x9a\xec\x4f\x93\x73\x80\xe1\xa7\xcb\x39\xc6\x51\x36\x39\x5f\xb8\x0d\x09\xa8\x3a\x91\xc2\x25\xb5\x75\x5f\x9a\xc2\x6d\x5a\xbb\x37\xcc\x52\x0f\xc8\x1d\x4d\x4b\xac\x48\x10\x14\x27\x03\x06\x2a\xb2\x4c\x63\x0a\xa5\xe0\x22\xc1\xa0\x34\xce\x61\x34\x4e\x91\x12\x4d\x62\x2c\x4d\x10\x92\x8c\x63\x38\x46\x12\x0c\x89\x4a\x8c\x24\xa3\x22\x44\x59\x8a\xf2\x72\x6a\x51\xc1\x38\x96\x96\x70\x51\x54\x64\x11\x97\x58\x9a\x21\x65\x82\x14\x39\x08\x31\x02\x65\x44\x45\x21\x25\x54\xc2\x80\x28\xa2\x14\x0e\x39\x85\x01\x0a\x40\x65\x86\x96\xa0\x44\xe0\x22\xa5\xb0\x77\xbe\xde\xa0\xb1\x8a\x10\xfd\x48\x90\x8f\x04\x17\x2f\x14\x85\x5f\x7f\xa7\x30\x82\xe4\xa8\x93\x77\x71\x8c\x64\x48\x96\xa0\x49\x16\x7d\x40\x30\xda\x5b\xcf\x83\xeb\x01\xe1\xbc\xff\xb0\xf0\xbf\xcd\x97\xd8\xf6\x0f\x6f\x4f\xc1\xf3\x3c\x5f\x60\xd8\x97\xa9\x53\x67\x72\x62\xa3\xf6\x82\xa2\xe8\x02\x92\xfd\x3c\x93\x43\x97\xcd\x8a\xed\x94\x1b\x73\x8e\xbe\x57\x31\xfc\xc3\x69\xda\xcf\xe4\x9b\xb5\x12\xec\xd5\x2b\x66\x96\xd9\xfb\x41\xad\x46\x8f\x84\x59\xf1\x43\x7f\xed\x76\xa1\x4d\x0c\x17\xdd\xd9\x47\xef\xe9\x85\xef\x74\x48\xa6\xdf\xf1\x40\xf3\xcf\xed\x61\xb3\xba\xe4\xb7\x17\x94\x1b\x65\x83\x2b\xa8\xcf\x43\x86\xe3\x17\x2f\x02\x07\xd4\xb2\xb0\xb2\x5f\x8a\x1d\x75\x48\x88\x8a\x5e\xe1\xdf\xda\xcc\xfd\xaa\xa6\xbc\x14\xfa\xa3\x75\x7e\x2e\xf7\x06\x64\x85\x1d\xcf\x5d\x59\xae\xd6\x97\xfa\x7b\xdb\xc9\x4b\xe3\xd1\x4a\xae\xcd\xd6\xbd\x27\xf5\x55\xa6\xd6\xcb\x66\x59\xf5\x20\x0f\x04\xb2\x01\x3e\xe6\x78\x67\x87\x8c\x6f\x95\xf8\xfd\x2b\xef\xfd\xf7\xc2\x3f\x63\x64\x87\xe7\x8b\xe8\x13\xff\xdf\x76\x05\x4a\x85\x3d\xf8\xbd\x07\x29\xd6\x1f\x37\x08\xf2\x36\xca\x7c\x07\x70\x92\xc3\x65\x8e\x63\x80\x84\x11\x84\xc2\xa1\x18\x01\x15\x09\xa7\x58\x45\xa4\x44\x89\x22\x44\xa8\xa0\x1c\x2b\x2a\x1c\xc7\xca\x12\xc5\x4a\x22\x85\x2a\x12\xad\xb0\xac\xc8\x28\x80\xf5\x4f\x1c\x89\xc0\xd3\x1d\xea\x36\x9b\xaa\xf2\x04\x4a\x13\xe9\x06\xb1\xb9\x1b\xe4\xc8\x34\x87\xb1\xe4\x11\x83\x60\x33\x1a\x04\xfd\xf4\xd4\x78\xd1\xe9\x65\xbf\x4d\xf1\x7d\x86\x7d\x1a\xdf\x63\xef\xe5\xd6\x3d\xfb\xa4\xe5\x8c\x31\x51\x7e\x6d\x0c\xda\xab\x77\xad\xa1\xd0\x2a\x3f\xd0\x1b\x0b\x1b\xd3\x9e\x2b\x55\x63\x3c\xa0\x7a\x46\xb7\x2a\x2b\xe5\x0e\xb7\x6e\x15\xdf\x38\xbd\xdc\x5c\x97\xdf\x48\x94\x7e\x72\x44\xe6\x39\xb0\x02\xdf\x20\xd4\xdd\x82\xe6\xec\xb7\xfe\x6b\xad\x31\xea\xbf\xcb\xa5\x7b\x1c\x15\xdd\x0f\x19\x00\x8e\x28\xb5\xdd\xc1\xac\x4c\x8e\x7a\x2d\xb6\x5e\xeb\xf2\x6b\xae\x56\x2b\xb0\x4f\x38\x3e\x74\x00\xc1\x2d\x7a\xae\x4b\x90\x45\xae\x63\x35\x5f\xfb\x54\x8e\x54\x07\x62\x19\xb8\xb9\x9a\x3e\x02\x82\x2a\xeb\x54\xd5\xb7\x81\x4e\x82\x41\x34\xd5\x98\x3e\xfd\x2f\x18\x04\xe1\xdb\xc4\x19\x06\x41\xdc\x46\x99\xef\x18\x0a\xa5\x59\x09\x48\xb8\x82\x41\x1a\xa0\x22\x2e\x01\x05\xe0\x32\x25\x8b\xa2\x24\x49\x94\x84\x71\x34\x83\x31\x0a\xad\x28\x0a\xcb\x70\x9c\x24\x11\x40\xa4\x01\xcd\x51\x22\xca\x88\x1c\x06\x82\x23\x78\x3c\x51\xb7\x99\x54\x95\x27\x71\x1a\x4f\x37\x17\xef\xae\x17\x5d\xc2\x9d\x15\xc6\xb2\xec\x11\x83\xa0\x32\x1a\x04\x31\xa8\xbc\xd6\x97\xef\x55\xc3\x6a\x34\xea\xf7\x1a\x26\x2f\xd8\x8f\xf2\xf2\xe5\x65\xa5\xe0\xb9\xdc\x94\x32\x9b\x2d\x1b\x18\xba\x98\x67\x66\x40\xfc\x78\x47\x3b\x95\xf6\xac\xf2\xdc\x93\x70\x49\xcd\x17\x8a\x73\x4b\xd3\x4a\x95\x2e\xa9\xe0\x86\x8d\xce\xf3\x5c\x05\x30\x63\xf5\xfe\x59\xac\xf9\x0b\xe8\x1b\x44\x44\x47\x7b\xdd\xc6\x60\x50\x75\xf2\xb9\xdc\x47\xd5\x79\xad\xf2\x16\xf6\xc2\x0f\xf2\x33\x8b\x5d\x91\xbd\xee\xb3\xb0\x06\x8a\xfb\xf2\x36\x34\xcb\x54\xb3\xfa\xea\xbe\x58\xfa\x93\xb2\x02\x4a\x0b\x2c\x73\x7d\x82\x18\x0c\x96\xfa\x47\x53\x6e\xb5\xea\xcf\x2a\x14\x8a\x79\xac\x0f\xdf\x4a\x45\xce\x1a\xfb\xf0\x9b\x09\x06\x51\x45\x93\x94\xea\xbf\xdc\x20\xf0\x73\x0d\x02\xbf\x8d\x32\xdf\xd1\x84\xcc\xb1\x0a\x45\xd0\x10\xd2\xac\x8c\x89\x38\x23\x52\x22\xcb\x29\x38\x01\x14\x8a\xc0\x30\x91\xa1\x68\x0e\xe0\xa4\x02\x14\x8c\x44\x09\x20\xa3\x22\x85\x8b\x34\x41\x78\x30\x20\xc7\x1d\x8b\x10\x74\xaa\xca\x53\x24\x43\xa6\x27\x54\x14\xc9\x78\x01\x22\xd8\xcf\x91\x14\x87\x1f\x31\x07\x22\xa3\x39\xe0\xed\x97\x57\x4c\x58\x50\x16\x2a\x3e\x31\x23\xd2\x5c\xb7\xde\x07\xab\x0a\x31\x9c\x5b\xb3\xfb\xf7\x32\xdf\x72\x0b\x58\x1d\x6f\x32\x79\x86\x7e\xc9\x35\xa9\x5a\xaf\xf0\xd6\x25\xee\xe7\x1f\xe5\x51\xbd\xd3\xfa\x28\xa9\x9a\xaa\xbb\xe4\x53\x8f\x87\x45\x66\x6c\x5b\x4e\x09\x34\x72\x54\xad\x11\xe4\x2a\xbe\x39\xf8\x7f\xd5\xb6\xff\xf1\xbe\xc6\x3a\xbb\xcf\x4b\xbe\xdd\x99\x05\xcb\x8d\x0e\x3b\xec\xc2\x98\x37\x5b\xf7\xdd\xa7\x5c\xe1\xa3\x86\x0e\x5f\x9e\xe0\x3d\x05\xa7\xcb\xdc\x8c\xec\x93\xf2\x74\xd9\xee\x2c\x97\xa5\x21\xc3\x18\xe6\x0b\xa0\xa7\xc3\x46\x63\x90\x2f\x55\xc1\x22\x07\x57\x4f\xf4\x4c\x68\xd6\x3e\x3e\xda\xc3\x77\xec\xb9\xc5\xc1\xe5\xbc\xba\x7a\x1e\xf2\xe5\xb6\x1f\x25\x6a\x09\xe6\x52\x72\x92\x54\xee\xbf\xdc\x5c\xce\x8e\x1f\xd8\x6d\x54\xdd\x6f\x1f\xdd\xec\x11\x30\x8e\x41\xbf\xa1\xd8\x37\x14\x43\x50\xf4\xd1\xff\x97\xaa\xd2\x34\xcb\x50\xe9\xf1\xc1\xbb\xeb\xc5\x07\x12\xe7\x48\x8e\x66\x70\x8e\x3e\xa2\xf1\xc9\xfa\x1e\x90\xf4\x4f\x2f\x4d\xfa\x95\x7f\xae\x6b\xe4\x3a\xb7\xee\xd5\xf3\x4c\xd1\x2c\x72\x55\x1c\x5d\xbd\xe6\xef\x1d\x54\x75\x9d\x65\x6d\xf9\x81\x3d\xcb\xbd\xd1\x18\xe4\x9f\x40\xb0\x37\x28\x25\xa8\x72\xf2\xb5\x51\x65\x9e\xcf\xcf\x7e\x01\x23\x37\xbd\xb6\x1b\xce\x50\x95\x4f\xec\xc1\x33\x3c\xdf\x79\xe9\x96\x3c\xa5\x6d\x34\x62\x3f\xc1\x06\x96\x44\x29\xbf\x5c\x9f\x62\x77\x27\xc0\xe0\x31\x30\xf8\x65\x60\xe2\xe7\x22\xc4\x65\x60\xc8\xf8\xc9\xd1\x65\x60\xa8\x58\xbd\xff\x42\x6a\xe8\xf8\xb1\xc1\x65\x60\x98\x0d\x18\x16\x23\x19\xe2\x62\x6a\xd8\x58\xa5\xff\x42\x6a\xb8\x78\x31\xfd\x32\x30\x18\xba\x5f\xde\x25\x2f\x04\x83\xc5\xaa\xc4\x17\x82\xc1\xf7\x8b\xa0\x97\x52\x43\xc4\xaa\xc3\x17\x82\x89\x95\x26\x2f\xa5\x86\x8a\x55\x38\x6f\xf3\xc8\xf5\x4d\xce\x9d\x8f\xf7\xa3\x3f\x20\x1e\xed\xd9\x0e\xa2\x53\x9e\x3c\xbe\xda\x6b\x46\x5c\xdc\x9e\x7f\xdb\x7e\xa0\xfd\x12\x10\xe6\x97\x70\x5d\xeb\xaa\x6a\xed\x03\xf2\x59\xb1\x2d\xe3\xaa\xca\xfa\x03\x12\xa9\x5c\xe3\xbf\xdb\x69\xe4\x4f\xe8\xdb\x49\x58\xa9\x7d\xdf\xbf\xfd\x80\x1e\xae\xd4\x15\x52\xde\xae\xd4\xa5\xd2\xd8\x5b\xa9\xdf\xee\xdc\xf8\x27\xf4\x25\xa5\xaf\x54\xd8\x29\xb0\xfd\xf0\x93\x6c\xea\xff\x5f\xa9\x6b\x57\x2a\x4c\x3d\x76\x1f\x70\x7f\x99\x82\x13\x33\xbf\x87\xdc\x63\x06\xfd\x4e\x45\x04\xb4\x95\x1c\xb9\x2f\xb9\xe0\xc1\x76\x8f\xfb\xbf\x3f\xcb\x9f\x1f\x11\xfc\x01\xf9\x6c\x7e\x7e\x44\xb0\xff\x3c\x20\x9f\x37\x0d\xd6\x9f\x1f\xbd\x24\xfa\xb3\xb8\x58\x6b\xa6\x3a\x49\x14\xf6\xde\xbd\x63\x32\x77\xa0\xae\x1f\x8e\x0c\xcf\xef\xe2\x80\xfe\x9b\x96\x66\xaf\x71\x63\xfb\x81\xf4\x97\x86\xce\xd6\xe0\xe0\xda\x0b\xc7\x85\xf0\x5a\x33\xf1\xc1\x58\xf6\xb5\x16\xfb\x7b\x18\xd5\x8d\x7b\x3f\x53\x57\x6e\x93\x41\x6f\x3f\xa0\xff\xf0\xca\x5d\x93\x7b\xfc\x16\x2b\xf7\xf3\x53\x8c\xe8\x66\x63\xfb\x37\x1b\x69\x50\x50\x16\xa6\x1c\xf2\x72\x61\xe7\xad\x2f\x97\xa0\xff\xf5\xda\xc5\xcd\xd0\x2d\x71\x65\x8b\xf0\x39\x62\x0b\x77\x45\xdb\xbf\xc9\x9f\x2a\xb6\x2b\x94\xf9\x37\x13\x5b\xb0\x7d\xdb\xfe\x8d\xfe\x54\xb1\x5d\xe1\xbd\x7f\xbe\xd8\x4e\xec\x05\x13\x7e\x32\x29\xcb\x3e\xf0\x34\xd4\xd3\x3f\x02\x73\xe9\x7e\x33\xf5\xa9\xe7\xc4\x3a\x1d\x9d\x5e\x53\x38\x09\x08\x8f\x01\x4a\xab\xff\x9c\x04\x44\xc4\xf6\x56\x69\x35\x97\x93\x80\xc8\xf8\x26\xed\x52\x40\x54\x6c\x0f\x71\x31\x45\x74\x0c\xd0\xc5\x32\x62\x62\xb9\xf2\xc5\x14\xb1\xb1\xcc\xee\x62\x8a\xb8\x78\xa2\x71\x29\xa0\xbd\xca\x1d\x9b\x5e\x9d\x3a\x0d\x08\xdb\x07\x74\xb1\x8c\xf6\xaa\x77\xe4\x35\x14\x11\xb1\xe8\x74\x31\x20\x72\xdf\x5f\x5f\x4e\x11\xb5\x0f\x28\xbd\x86\x77\xee\x8f\x18\xdd\xa2\x8a\x77\xea\xc7\x16\xce\xa9\xe3\xa5\xfe\x64\xd1\x0d\x3c\x6b\xe4\xa9\x37\x00\x30\x9a\x55\x30\x1c\xc3\x49\x91\x91\x30\x8e\x96\x50\x20\x03\x08\x19\x89\x21\x00\x4d\xca\x04\xa3\x78\xcb\xcf\x4a\x40\x12\x29\x0e\x70\x98\xa2\x10\x2c\x47\xe3\x34\x4b\x52\x90\x91\x94\xbb\x07\x24\x68\xfb\xbd\x3c\xd9\x8c\x9c\x83\x93\x9b\x93\xbf\xf4\x5e\x43\x9a\x38\xd2\x88\xe8\xdf\xdc\xf3\xea\xc1\x81\x61\x85\xb2\x9e\xdc\xa1\x6c\x8e\x5b\x43\xf9\xe5\xcd\x7d\x9e\xf7\xab\x79\x57\x94\xc6\xa8\x51\x30\x14\x29\x5f\xab\x97\xd4\x91\xa9\xbf\x97\x6b\x53\xc0\xfb\x07\x6e\xfc\xe6\x58\xbb\x10\x3b\xcf\xca\xef\xfe\x0c\xce\xc6\x5b\x78\x21\xc7\xb7\x48\x6a\x9c\x2f\x12\x6e\x75\x58\x6e\x61\x5d\x82\x47\x9b\x70\xd6\x66\x9f\xba\xb4\x29\x60\x3c\x07\x47\x9a\xbc\xae\xb9\x03\x7f\xfe\x70\x28\x84\x0d\x80\x85\x85\x45\x58\x2e\x49\xbd\x15\xda\xa5\xd5\xbc\x93\x23\xac\xaa\x70\xff\x81\x31\xdd\xb5\xe6\x60\xba\xd2\x2c\x8f\x8d\xce\x48\xb5\x17\xbd\xfb\x7e\x80\x9a\x10\x5e\xa2\x87\x85\xe5\x2d\xbd\x9d\xba\x54\xe9\x71\x2d\x67\x68\x0e\xab\x85\x61\xad\x8a\x92\x05\xee\xa5\xfe\xf1\x51\x1f\xe7\xbb\x72\xc1\x58\xdf\x3f\x2d\x8d\x0f\x5d\x66\x3a\x12\xdf\x68\xad\x5e\x06\x12\xaf\xce\x16\x15\xc5\xea\xc9\xef\xcf\xf3\x2a\xc1\x1a\xc2\xbb\xfd\xd6\xd1\x40\xd3\xe9\x09\x46\xff\x69\x34\xee\x7e\x54\xdf\x55\xeb\xc7\x5d\xf4\xc0\xb5\xd2\xcf\x79\x97\xff\xf7\x8e\x8c\xbc\xff\x65\xd0\xc1\xb5\x1b\xdf\xd9\xca\xaf\xe8\x0f\x8a\x90\x2d\x1a\xaa\x81\x0d\x71\x59\xa5\x86\x98\xf1\x86\x41\xbd\x29\x55\x30\x77\xf5\xda\x1b\xd7\x5f\xb8\x65\x49\xb5\x7a\x79\x00\x47\xec\x40\x2b\x5b\xbe\x90\x86\xfc\xfb\x6b\x6b\xb7\x1e\xf9\x18\xfe\xbd\xb5\x48\xb8\xf2\x37\xc6\x5f\x38\x13\x3f\xbf\x95\x89\x2f\xa3\xe6\x56\x26\x21\x79\x0b\x50\x10\x87\xcf\x2f\x78\x51\x7f\x1e\x01\x7b\x48\x0f\x56\x4b\x71\x44\x54\x84\x27\x75\x6e\x12\x7c\xaf\x30\xad\x95\xe7\x94\xb8\xea\xd5\x46\xfe\xfc\xa7\x41\xe1\xbe\x25\xed\xe0\x95\xf8\x7d\x9d\x0c\xaf\xd4\x33\x65\x7f\x7c\xf9\x3a\xfc\x4d\xf2\x32\xfc\x3f\x7c\xfd\xf8\x7b\xbe\x7c\x69\xa0\xf4\x6a\x24\x0f\xa4\xa7\x81\xaa\xf4\xd5\x06\x36\xb3\xdb\xcd\xb9\x5a\x2e\xa3\x75\xb1\x41\x9a\x05\xb1\x35\x24\xdc\xfc\x92\x77\x98\xb2\xde\x5d\x16\x0a\x3d\xf2\xe5\x7e\xfa\x84\x73\x70\xa6\x28\xeb\x31\x7e\xbf\x98\x17\x9e\xac\xf5\xaa\x86\xbf\x34\xf5\x97\x69\xb5\x09\xef\x0b\xea\x8f\x1f\x7e\x32\xed\xff\x34\xd6\xa6\x8b\x21\xcb\xff\xfe\x1b\x2c\x7c\xaf\x73\x3a\x24\x45\x1f\x16\xa6\x21\x81\x63\x34\x4a\x52\x32\xc5\x70\x22\x04\x24\xaa\xe0\x32\x41\x01\x94\x23\x51\x5a\x86\x04\x60\x39\x12\x4a\x22\x25\x42\x06\x95\x45\x19\x50\x50\xe2\x24\x94\xc4\x19\x80\xca\x14\xc0\x82\x07\x38\xb1\x6b\xea\x62\x11\xb7\x49\x9c\x72\x9b\x04\xca\x70\xd8\x91\x7e\xd5\xe0\xee\x5e\xf2\x19\x28\x6d\x9d\x7e\x85\x1a\xf1\x6a\x58\x35\xb6\x5f\xd1\x8b\x39\xa8\x4a\x04\xd3\x7e\x76\xab\xf5\xfa\xc7\x68\xc8\x2e\x87\xda\x4b\x1e\x14\x16\x54\x83\xf2\x35\x3b\xe2\x38\xe3\x4a\x71\xe0\x38\xcf\x34\xc4\x2b\x1c\x27\xcf\x18\x8e\x15\x21\xa5\xb2\xa5\xb7\x53\x32\xeb\x45\xb1\x38\x7e\xaf\xcf\x9e\x5e\xc7\x75\x14\xd8\xef\xd3\xb2\x6e\xde\x57\xea\xe8\x3d\xc3\xaf\x69\x15\x05\xf7\xd8\xf4\xb5\xdb\x85\x7a\x89\x87\xe4\xd2\x78\x85\x6f\x82\xd4\x55\x71\x83\x2c\x98\x8c\x4b\xf2\xaf\x4f\x1f\xbc\x53\xec\xd4\x50\xed\x19\x4c\x2b\xa2\xf5\xd4\xae\x09\xfc\x32\xe6\x38\x3b\x49\x86\x11\x95\x4f\xba\xe3\x8c\x0c\xb2\xdf\x04\xba\x01\x5b\x40\x7d\x5d\x35\xc1\xa0\xcd\xd1\xf9\x0f\xc5\xe1\x20\x2a\x59\xb6\xf0\xf2\xfc\x91\x1f\x3d\xcd\xca\x56\x9d\x99\xbd\xcf\xfc\xa6\x5e\xcf\x71\x69\xd8\x6e\x3d\x52\xae\x13\x8e\xf3\x76\xf8\x0f\x9d\x44\x06\xfc\x07\x4e\x33\xe8\x82\x39\xd3\x69\x95\x87\x03\x34\x14\xfc\x99\xfa\x1c\x92\x92\xdb\x5e\xcb\x24\x9a\x4b\xbb\x2f\x7f\x35\x7d\xc5\x05\x58\xab\xc7\xe8\xfb\xf1\x23\x21\x00\x45\x92\x9a\x73\x6d\xc9\x0b\x00\x21\xad\xf1\xb6\xed\xe8\x75\x3c\x00\x95\xae\xc3\x1f\x0d\x80\xe7\xe0\x0f\x03\x50\x4f\xb2\x04\x47\xd0\xd8\xb7\x8e\x21\xa8\x76\xf7\x6d\x71\x5f\x1a\x8d\x14\x72\x6c\xf7\x19\xa7\xd8\x78\x2b\x76\x6d\x66\x54\x11\xca\x65\x7a\xd0\xc9\x33\xaf\x05\x20\xd0\x16\xb6\xaa\x14\x81\xa8\xd6\x95\x05\xa1\x16\x9a\x66\xb3\xb0\x14\xf8\xd7\xde\x93\xfc\x56\x7a\x59\xa8\x33\x56\x45\x8b\xfc\xa5\x01\xc8\xdb\x0d\x9c\x1f\x7f\x30\x89\xa4\x48\x9a\x40\x71\x9a\x01\x80\x65\x68\x06\x4a\xac\xc4\x42\x02\x25\x29\x54\x82\x80\x16\x01\x4d\xa3\x18\x49\x41\x4e\xe2\x70\x12\x88\x22\x43\xc9\x0c\xa0\x69\x9a\x13\x69\x09\x67\x41\x10\x7f\xf0\x1b\xc5\x9f\x93\x69\x3b\x81\x72\xe9\xcd\xb0\xe1\xcd\xbd\x42\xc3\xb5\xd1\xe7\x37\x4a\xdb\x8f\x44\x9f\xe2\xbc\x36\xe3\xde\x08\xd4\xfd\x50\x3a\xb3\x79\x67\x51\x58\x96\x19\x0d\xb4\x09\x51\xa0\x8b\xdd\xc2\xec\x7e\x39\x20\x86\x2c\xcd\xb8\x6f\xb3\x46\x67\x48\xd4\x64\x92\xc2\x47\x4e\x7d\x30\x9e\xb7\x3b\xb6\xc0\xc2\x57\x5a\x99\xa1\x8b\x15\x84\x46\x5e\x70\x3e\x30\x81\x1a\x36\x1d\x4e\x1d\xff\x8e\xd1\xe7\x22\xef\x7f\x43\xfc\x71\x7d\xc8\x84\x3f\x39\xfa\xf0\xcc\xb8\xc1\xf2\xcc\xab\xae\x96\xda\x10\x95\x07\x03\x66\x58\x95\x8a\x9d\x15\xdd\xc9\x2d\xf5\xea\x9b\x44\x0c\x8a\x18\x05\x9e\x88\x9a\x86\xf9\xe3\x7f\x75\xf4\xf9\x85\xf4\x5d\x16\x7d\xfe\x21\xef\xcf\xdf\x28\xfa\x44\xb7\x3f\xe7\xe0\x0f\xa3\x4f\x6b\xa6\xf5\x71\x5b\xe9\x11\x02\x57\xe8\xe9\x05\xb2\xc1\x3f\x2f\x9e\xac\x9c\xec\x10\x96\x50\xaa\xf7\x99\x7c\x5f\x7e\xfe\xb0\x17\xf8\x5b\xc7\xcd\x3f\x4b\x53\xe2\xd5\x7c\x01\xcb\x79\x57\x9b\x71\x05\x87\x58\xd1\xed\xf9\x7d\xbf\xc7\x94\x29\x7a\x5c\xc2\x3f\xda\x03\x42\x1f\xac\x3f\xf0\xfc\xc5\xdb\x9f\xcb\xa2\x0f\x07\x45\x08\x65\x28\x4a\x14\x2e\x03\x02\x63\x65\x5a\x94\x09\x8a\xa4\x49\x92\xe0\x08\x8e\x41\x65\x99\xa1\x50\x5a\x14\x59\x51\x01\x2c\xad\xd0\x84\xc4\x72\x12\x45\x33\xac\x84\x32\x12\xe5\x3f\x17\x41\x06\xcd\x12\xb7\x88\x3e\xd4\xc9\xe8\x83\x61\xcc\x91\x67\xf9\xc2\xbb\x7b\xf5\xe9\x6b\xe3\x4f\x31\xb6\xf8\x11\x57\x16\x31\xed\xe1\xb0\xdf\x0d\xff\x3c\xd3\xbf\x45\x82\x8a\xaf\xce\xc9\xfe\x0d\x6c\xc6\xe7\xf9\x77\x67\x41\x29\xf7\xef\xcc\xd0\x7e\x2a\x56\xeb\x0b\x9c\x1d\x2d\x4b\xf8\xc7\xb2\xd8\xa1\xf4\xe6\xc8\x2c\x30\x65\x4b\xed\xe9\xfd\x9c\xf0\xba\x52\xab\xab\x22\x33\x9b\xbd\x54\x9b\x23\x5c\x9f\xbd\x8e\x57\x39\xae\x47\x52\x4e\xed\xa9\x52\x68\x91\xef\xaf\xf4\xbd\x5a\x7b\x5f\x55\xed\x25\xad\xe7\xa3\xf6\xcd\xa7\xc6\x9a\xb8\x2c\xf8\x4b\x64\x1b\xe1\xf5\xa7\xcb\xee\x17\xc4\xc3\x8b\xe2\xd1\x0d\xf1\x27\xaf\xc9\xa9\x78\xe8\x83\xba\x85\x0f\x6f\xf8\x49\x55\x24\x26\x1c\x5e\x3f\xd5\x87\x1f\xe0\x3f\x55\xc2\x3a\xb8\x1f\x4b\xea\xe2\x13\x83\xf5\xfd\x6f\xd0\xf1\x9b\xc5\xe5\x4b\xe3\x22\xff\x13\xd6\xf4\x1c\xfc\x61\x5c\xfe\x59\x0e\xf2\x57\xc6\x65\x0a\xc3\x00\xa6\xe0\x14\xc4\x14\x0a\x02\x5c\x96\x50\x11\xc5\x38\x9c\xc0\x14\xc8\x70\x38\x43\x28\x92\x84\x33\x24\x83\x4b\x38\x41\x4b\x14\xc7\xa2\x8a\xc4\xc9\x92\x2c\xd3\x32\x87\x51\x10\x0f\x1f\x86\xc7\xae\xe9\xf9\x3a\xa7\x2a\x49\xe2\x2c\x89\x1f\x79\x68\x38\xb8\xbb\x77\xdc\x1b\xe8\x6c\xd1\x55\xdf\x97\xc5\x45\x6b\xc4\x77\x38\xa6\x8b\x75\xfb\xee\x40\x5e\x0a\xc5\xea\xbc\x98\x2b\x0c\xe0\xfc\x43\xee\xb4\x9f\x75\xcb\x94\xb4\xc6\x90\xcf\x5c\x95\x1c\xf3\x17\xef\xf3\xaa\xbb\x14\x38\xa2\xd3\x5b\xfc\x9d\x6a\x09\x9b\xdf\x53\x6e\xbe\xfd\xc6\xce\x07\x56\x85\x7f\x7e\x6b\x71\x3d\x06\x2c\xa9\x16\x27\x9a\x2c\xd3\x5d\xb7\x97\xe8\x33\x26\xd7\x51\x99\x99\xf6\xba\x34\xb3\xa8\xe4\x66\x53\x7e\x5d\x20\x2c\xae\x6f\xb7\xfb\xf4\x07\x27\xbf\xcc\xa6\xc6\x73\x4e\xe0\x67\xac\xb9\x32\xb8\xa9\x3e\xee\x94\xb2\xc4\xde\x4a\x54\xd1\xd3\xe2\x1a\x1f\xf9\x2d\x8c\x33\xf7\xc5\xfe\xf1\x88\xb9\x93\x6f\xca\x95\x25\xae\xdc\x04\xff\x65\x55\xc6\x5d\x5c\x8b\xc6\xc5\x33\xf7\x51\x89\x47\x33\x87\xd7\x71\x1f\x78\x6b\xfc\x67\x1c\x0d\xf1\xfc\xef\xbb\xcf\x3d\x55\xc5\xbc\x44\x56\x57\x57\x31\x6f\xb8\x56\xe7\xe0\x0f\xe3\x95\xd4\x1f\x99\x8c\x81\x96\xee\xed\xb5\xde\x53\xc7\x79\x68\x31\x58\xc3\xb5\x8b\x33\x06\x5b\x28\x1f\x6e\xb5\x96\x2b\x76\x95\x21\x6a\x77\x89\x45\xf9\xa9\x6a\x2f\x48\xf1\xbe\x57\x2a\xd6\x1a\xf0\x15\x6b\x39\x5c\xdb\x6e\x63\x98\xd1\xab\xbc\x28\x2c\x5a\xe8\xaf\x95\x8a\x88\x57\x86\x53\xbe\xf3\x6b\xe3\x15\xc0\x65\x20\x2a\x24\xe4\x64\x8c\x26\x71\x06\xc7\x69\x14\xc7\x19\x1c\x62\x0c\x0b\x08\x46\xe2\x18\x42\xe2\x30\x86\x11\x39\x8a\x91\x01\x4b\x63\x1c\x0e\x38\x4e\x24\x20\xa7\x10\x80\x03\x80\x0c\xe2\x15\x7e\xa3\xe6\x83\xd3\xf1\x8a\xc0\xd0\xf4\x53\xb4\xcd\xdd\xbd\xae\xa2\x6b\xdb\x0f\x7e\x61\xbc\x8a\xb4\x13\x54\xb5\xc6\xbc\x24\x8c\x18\xe2\x55\xea\x63\x3d\x79\xa6\xe4\x20\x58\xbd\xf6\x1a\x95\x7e\xa7\xa0\xd6\x4c\x88\xba\x04\x09\x6a\x70\x2d\x4f\xe7\xfa\xd0\x1d\x71\xab\x62\x87\x9e\xf2\x7d\x82\xad\x70\x33\xcd\xae\xd7\xbb\xb5\xb5\x55\x5f\xcc\xac\x81\x20\x4c\xf9\xa5\x3c\x5a\xe7\xda\xaf\x1d\xe9\xa7\xc4\xab\x4b\x8e\xf3\x6f\x19\xaf\xae\xc4\x7f\xc3\x78\x75\x93\x56\x82\xc3\x2b\xb3\x0f\xfc\xd5\xad\x0c\x3c\xff\xfb\x9e\x0a\x9e\x8a\x57\x97\xc8\xea\x96\xf1\xea\xda\xb5\x3a\x07\x7f\x18\xaf\x60\x6d\x31\xeb\x60\xe2\x3b\x14\x56\xed\xe1\x13\xde\xcd\x71\x94\x5d\x11\x6a\xce\x8b\xc0\xd7\x79\x4d\x66\x7a\x84\x32\xb5\xa6\xcc\x13\x5e\x31\x86\x23\x4c\x24\x4a\x42\xf1\xad\x94\x6f\x2b\x4b\x11\xef\xd5\x1d\x6b\x5e\x7a\xad\xab\x6f\x74\x6f\xda\x41\xf1\x52\x31\x8f\x89\x0d\xf6\x5e\xc8\x2f\x7f\x6d\xbc\x12\x71\x80\xe3\x8c\x44\x70\x12\x4d\x02\x92\x54\x24\x06\x88\x32\x29\x71\x34\x8b\x71\x24\x45\x2b\x28\xc1\x71\x1c\x4a\xcb\x18\x2e\x91\x0c\x2d\x33\xa8\x48\xa2\xb8\xff\xe3\x66\x1c\x2d\xd3\x80\x08\x7e\x06\x07\xbb\xa6\xe9\x3b\x78\x20\xf0\x68\x98\xa2\x48\x0e\x4d\x6f\x92\xdb\xdc\x8d\x76\x9a\x86\x51\xaa\xc1\x56\x3b\xef\x9d\x99\x58\xc7\xab\x3c\x31\x1a\xbe\x76\xed\xba\xf1\xfa\x8c\xa2\x4a\x85\x75\x1a\x35\x2f\xd9\xe8\x2e\x9f\x46\x39\xfe\x99\xe0\xb7\x51\x2a\x50\xa7\xd8\x92\x1f\x58\xf1\x05\xd5\xaa\xe8\x2f\x5d\xe4\x87\xef\xcb\x32\xe7\xdd\x2a\x15\x5d\xa2\xbe\x34\x40\x7b\xd1\x96\xcb\xbd\xc1\x4a\xe6\xcb\x50\xa4\x5b\x1d\xe8\xae\x3b\xf5\xda\x08\x7c\xe8\x62\xaf\xd9\x9c\x1a\xd5\xba\xd0\x28\x92\xce\xdb\xb4\xf4\x36\x78\x91\x3a\x6d\x54\xbf\x7f\xce\xb5\xe6\xf7\x96\x33\x32\x04\xfa\xbe\x3c\x18\x8b\xce\x07\x43\x75\xf0\xd7\x0a\xf9\xde\x6c\x66\x88\x4c\x7b\x2a\xbd\x1f\x99\x22\x3c\xef\x3c\x73\xd4\xda\xb5\x5c\x1e\x6d\xa0\x4f\x95\xb5\x3b\x5d\x0a\x98\x3e\x46\xc1\x7a\x6e\x61\x9c\x50\x5d\xbd\x37\x0a\xeb\x16\xe5\xe6\x4b\x52\x21\xe0\x91\x50\x5d\xbb\x65\x8e\x73\xcc\x60\x37\xff\xa2\x0a\xd9\x15\xf8\xcb\xfd\x51\xde\xbe\x02\x3f\xcf\xff\x73\x3d\x06\x89\x9e\x37\x7f\xb9\x2c\x5a\xe6\xcb\x51\x36\x4f\xc9\xe2\xda\xb5\xf0\x74\xe1\x5e\x8a\xc1\x3b\x4b\x16\x7f\x33\xf2\xda\x79\x32\x5e\x99\x57\xa2\x3b\xd0\x9b\xcf\x9d\xfc\xb3\x71\xff\x3a\xab\xda\xd2\xac\xa0\x95\x0d\x87\x1a\xa1\xaf\xc5\xda\xcb\x74\xfd\xda\x5b\xde\x37\xea\x56\xb7\xae\x57\x9e\x4b\x45\xee\x49\xd1\x73\x1f\x6f\xca\x5b\xa3\x3c\x7f\x85\xef\xd3\x61\xa5\xc2\x34\xef\xef\x07\x82\xb5\x5a\x34\x3e\x7e\x75\xbf\x03\x29\x13\x24\x24\x49\x14\xa3\x28\x42\xa1\x49\x40\x73\x12\xa0\x09\x16\x27\x29\x8e\x55\x48\x99\x53\x50\x80\x73\x22\xaa\x40\x42\x82\x04\x2b\x91\x90\x94\x19\x94\x44\x65\xa0\x28\x18\xae\x28\xca\xee\x57\xed\xae\xf0\xbc\xf8\x49\xcf\x4b\x61\x47\x7e\x34\x72\x73\x37\xda\x51\x7f\xad\xe7\x3d\xd2\xe7\x10\x5c\x17\xe4\xa7\x29\x9e\xb7\x20\x17\xdd\x0a\xbe\x32\xd4\x4e\xae\xc9\xbb\x6f\x6f\x8a\xa2\xe6\x9b\xf7\x03\xe5\x65\x58\xfd\xe0\xac\xe2\xca\xfd\x28\x0b\x32\xc5\xce\x72\x06\x2e\xea\xed\x8a\x59\x13\xc5\x05\x04\x86\x3b\xef\xbc\x17\x38\xd2\xee\x4e\xc1\x32\x57\x75\xf2\x25\x05\x00\xee\xed\xf5\x65\xc9\x8c\xe7\xc3\x59\xe5\xf7\xf2\xbc\xd7\x7a\xbe\x2b\xad\xfd\x8d\xc9\xf5\x8b\xe2\x0d\x3d\xef\xaf\xcc\x33\x4f\xe6\xbc\xbf\xd0\xf3\xf1\x37\xf2\xbc\x2c\xb9\x9b\x9f\xb2\x5f\x3c\xe6\x79\xcd\x0e\xd3\x75\x9d\x17\xab\xd4\xfe\xe0\x1b\xe0\xcd\x24\x48\xbe\xdf\xd6\xab\xf8\xb0\xcb\xe6\x00\xcf\x8a\xd2\xaa\xff\x0c\x95\xa7\x36\xe5\x1a\x54\x7f\x35\x5f\x57\x70\xc6\x34\xe6\x36\x18\x34\x96\xef\xb0\x8e\x8e\x47\x4e\x7b\xc5\xf0\xdd\x2a\x6e\xbc\x03\x0b\x97\x5a\x78\x7d\xf8\xf2\xab\xcf\xfa\x19\x9c\x62\x28\x5a\xc4\x14\x51\x56\x58\x42\x44\x59\x0c\x67\x14\x82\xa5\xa0\x02\x65\x05\xe5\x50\x4e\x92\x58\x1c\x15\x69\x49\x82\x0c\xa6\x60\x12\xca\x72\x8c\x8c\x51\x24\xce\x48\x22\x05\x64\xf9\x6e\xfb\x53\xe2\x57\x78\xde\x93\xa5\x19\x8a\xc2\xd3\x7f\x7c\x2e\xbc\x19\x7d\x6e\xe8\x5a\xbf\x7b\xe4\x7c\x3f\xb8\x2e\xa8\x63\xa7\xf8\xdd\xfc\x2b\xa9\xe6\x3b\xb9\x3c\x2f\xaa\x6f\x0a\xf3\xd6\xb2\x5c\xe0\xaa\x2f\x83\xea\x6b\x51\x77\x5a\x6e\x51\x90\xe7\x0c\xd0\x5f\xba\x54\xae\x3c\xe3\x94\xca\xeb\xbd\xbe\x2a\xad\x55\xfe\x65\xf4\x31\x66\x72\x8d\x31\xf6\x42\xf4\xca\xb4\x84\xbe\x39\x18\x83\x37\xa6\xfc\x6c\xf6\x3e\x64\xe7\xe8\xef\x95\xf1\x5e\xed\xf7\xae\xf5\xbb\x6b\xbb\x53\x6e\xdc\xd0\xef\xfe\xca\x7a\xf4\xcf\xf0\xbb\x97\xfa\x3d\xfe\x46\x7e\xf7\xd2\xdd\x4f\xe8\x77\xc7\xf7\x35\x7e\xd0\x5e\x76\x2a\x64\xdd\xbc\xa7\x5f\xdf\x1a\x23\x7b\x5c\x19\xe6\xc9\x25\x25\x16\xed\xce\xc7\x33\x80\xf8\x7c\x34\x80\xca\xea\xa5\xfd\xbc\xb2\x72\x73\xa9\xdb\xb4\xf8\xca\xd0\xc1\x5b\xb9\x35\x2e\x8c\x64\x74\x0a\x4d\xa1\x6e\x0b\x90\xd3\xc8\xce\xd3\x53\x03\x53\xea\xf2\x6d\x32\xde\xfd\x67\x15\xa3\x2f\x44\x8e\xbe\xb9\x73\x3e\x83\xeb\xcd\x33\x7f\x85\x96\xd0\xeb\x77\xf9\x9a\x70\xf6\x8b\xa4\x23\x10\xfd\x17\x8f\xf3\xc5\x62\x04\xda\x01\x42\xa4\xdd\xad\x35\xf9\xee\x18\xa9\x97\xc6\xc8\x17\x4d\x3e\xa0\x36\xfe\xe6\xbc\xd8\xe7\x1b\x51\x1d\x83\x9a\x44\x79\x12\xe2\x93\xd4\xc7\xde\x61\x16\x7b\xe1\xd7\xee\xe7\x3a\x22\xbf\x8a\xb3\xf7\x0b\x38\x93\x9b\x70\xb7\x8f\x36\x89\xb9\x8b\x08\x43\x06\x42\xad\x33\x28\x21\x5f\x76\xc3\x1f\x90\xdd\xf8\xcd\xdf\xc1\x84\x33\x45\x73\x9b\x65\x3d\x9b\xf1\xb3\x16\x35\xe5\x97\xff\x4e\xfc\xba\xde\x6d\x39\x4b\x46\x72\x8c\xd3\x23\x64\x65\xe6\x3c\xf5\x89\xe9\x93\xcf\x24\xdf\x96\xfb\x34\x34\xc7\xf8\x3f\x4a\xda\x49\x09\x04\x2a\x2d\xae\x7d\x6d\xdf\x30\x52\x13\x8a\xa5\xe7\x13\x3c\x14\xba\x25\xbe\x5f\x0a\x86\xee\x43\x41\x5a\x42\xdc\x18\x06\xbd\x9a\x50\x41\x44\xd7\x86\x30\x6a\x5d\xe9\xd4\x04\x36\x76\x3d\x3d\x01\x9c\x6c\x14\xa5\xd8\xb5\xb8\x7d\x6f\xe4\xc5\xe4\xec\x40\x44\x29\xd9\xdb\x29\xec\xd3\x13\x0c\x7e\x40\x36\x6f\x6a\xdd\xbc\x79\x3e\x89\x38\x05\xc2\xf3\x08\x9c\x5b\x8e\xab\xda\xd0\x49\xa4\x33\x02\x2d\x1b\xad\x91\x09\x5f\x91\x51\xb5\xd4\x2d\x21\x51\x18\xb5\x1e\x22\xb4\xfa\x7e\x0c\xff\xe3\x80\xf4\x29\x70\xa6\x37\xa0\xd9\x03\x93\x8d\xd8\xa8\xad\x78\xb3\x92\xe4\xa9\x99\x26\xb4\x6f\x45\xda\x0e\x58\x36\x02\x83\xf1\x07\x64\x86\x82\x4d\xbe\x7b\x5c\xc6\xc1\x2f\x9c\x5f\xa3\xba\x01\x84\x6c\xf4\x87\xaf\x02\xdf\xe8\xeb\x03\x02\xe6\x73\x5d\x93\x02\xff\x6c\xd9\x72\x4a\xdc\x9c\x40\xcf\x58\xfd\xfb\x17\x50\x1a\x86\xed\x80\xe0\x18\xb8\x28\xd9\x9b\x77\x67\xed\x51\x7c\x18\x46\x34\xf9\x01\xf9\xec\x4f\xfe\x9c\x46\xac\x26\xdf\x88\x4c\x4d\xce\x4c\xe0\xf6\x95\xf7\xf2\x43\x42\xec\x3b\x49\xb4\x35\x9f\xcc\x6f\x45\x77\x08\x2b\x4a\x7a\x4a\xee\x70\x11\x27\xc9\x0c\xb8\xab\xdb\x31\x10\xc2\x4a\xd1\xe9\x0b\x59\x88\x42\x48\x62\xc2\x9a\x7b\x5a\x39\xb5\x2e\xe2\x21\x24\x7e\x07\xe3\x52\xe1\x1f\x17\xb4\xb3\x79\x99\xbf\xe7\xbb\xae\x97\xf5\x3e\xb8\x28\xc9\x9b\x17\x2f\xec\x7b\xbf\x44\x8a\xa2\x72\xbd\x15\x59\x07\x30\x33\xba\xe7\x04\x02\xdd\x60\x49\xdc\x6b\x96\x75\x07\xe3\x72\x95\x3c\xa5\x7e\xae\x2d\x7b\x48\x44\xe0\x9c\x99\x2f\x24\x12\x7c\x08\x2c\x46\xb9\x0c\x63\x74\x46\xc7\x9e\x24\xd0\xff\xc1\xd6\xdb\x90\xe7\x83\xca\x44\xdc\xe6\x57\x62\x53\x49\xf3\x69\x87\xf6\xcd\xc4\x17\x83\x77\x8a\xc8\xd8\xf0\x2c\x94\xde\x46\x8e\x7b\xd0\xb2\x52\x79\x52\x9a\xb7\xa1\x2d\x13\x4d\xc7\x69\xd9\x50\xac\x5b\xd6\x6c\x31\xbf\x8e\xa2\x7d\x58\x99\x57\x34\xd8\x80\xa4\xd0\x37\x07\x9a\x3d\x71\x35\x03\xde\x84\xc2\x38\xb4\x6c\x76\x1b\x12\xf8\x80\xc4\x49\x7e\x40\x42\x17\x2f\xe9\x96\x03\xe5\x09\x70\x53\x98\xb8\x81\xdf\x0e\xe1\x9c\xa2\xf8\xcc\xec\xc8\x83\x7a\x33\xe9\x9e\x21\xd8\x93\x72\xd3\x4c\x19\xae\x26\xb1\x94\xc3\x99\x58\xe6\x04\xc8\xb2\x0d\x1d\xe7\x5a\x81\x9e\x44\xb0\xb7\x71\x0e\x6f\xc7\xb6\xaa\xc1\xc0\x33\x68\xbf\x5e\x0f\x8e\xc1\x3e\x4d\x71\x82\x95\xed\x03\x0c\xb3\x70\x0f\x9e\xbb\x9e\x5f\x5e\x14\x39\x0a\xf5\x64\xda\xef\x0d\x3a\x41\x68\x98\x43\x79\x20\xb7\x4a\x74\x23\x6a\x93\x40\x9f\x4c\xdf\xb2\x6a\x72\x04\xf8\xad\x95\x61\x0f\xf4\x25\xf9\x66\x3a\x38\x63\x6e\xd9\x9e\xe3\x7b\x87\xb6\xa3\x59\xe6\xed\x05\x1d\xc7\x70\x9a\xfc\xd8\x84\xec\xcc\x84\xae\x27\x7b\x91\xe3\x02\xf9\x47\x70\x9c\xe4\x24\x32\x36\x3b\x13\x73\x1b\xbe\x6b\xd6\xc2\xf9\x25\xdc\x24\x21\x3b\xc9\x56\xd2\xa4\xec\xfc\x6d\x8a\x28\x3f\x8d\xa7\x0d\x82\x93\x7c\xa4\x96\x1f\xf7\x41\xef\x7e\x6a\xfa\x67\x98\x76\x1c\x7a\xe2\x06\xf8\x5c\x03\xdf\x07\xba\xbf\x85\xba\x91\x85\x1f\x43\x91\x85\x87\x13\xfb\xba\xa3\xc8\x6e\x17\xbe\x0e\x01\x67\xa2\xfd\x74\x10\x8b\x6e\xb6\x7f\x86\xda\x1c\xc2\xbf\x78\xab\xef\x27\x71\xdb\x40\xbe\xa9\x30\x4e\x44\xcb\x9a\x5d\x2c\xe5\x23\x30\x4f\xa6\x08\x5f\xbe\xc8\xd0\x05\x9a\xee\x20\xdf\xfe\xfd\x6f\xe4\xce\xb1\x74\x39\x72\xbc\x79\xf7\xf8\xe8\xc2\x95\xfb\xf5\xeb\x03\x92\x3e\x50\xb2\xe4\x6c\x03\x83\xc3\x91\xf4\xa1\xa2\xb5\x50\xa7\x6e\x26\xf4\x7b\x43\x8f\x13\xb0\x37\x34\x46\xc2\xa6\x28\xee\x2b\x19\xf2\x03\x21\x88\xcc\x9d\x01\x9a\x3c\x51\x22\xe7\x76\xe5\xfa\xaf\xe9\x0f\x08\xd1\x22\xe5\x56\xb7\x54\xab\x08\xdb\x33\x39\xa4\x5b\x2a\x97\xba\x25\xa1\x50\xea\xc5\x8e\xa9\xfc\xbb\x2d\x01\x19\xb4\x8b\x9e\xca\x74\x4b\xbd\x7e\xb7\x56\xe8\x7b\x5f\x15\x4b\x8d\x52\xbf\x84\x14\xf8\x5e\x81\x2f\x96\x8e\x1c\x6c\x7a\xfb\x8e\xfd\x8f\x93\x58\x29\xe6\x76\xc2\xd8\xc7\x73\xe2\xd4\x32\x8d\x92\x7d\xf9\xc4\xcb\x46\x89\xc2\x0a\x13\xfd\x13\x47\xbc\xa9\x92\x08\xb7\xb2\xff\xb8\x1c\xa2\x74\x24\x49\x61\x53\x25\x38\xae\x30\xe7\x49\xe0\xb0\xa8\xf4\x0f\x8a\x21\x85\x98\x7d\x59\x24\x94\xc1\x6e\xab\x14\xf1\x12\xc7\xef\x20\x90\x74\xd5\x38\xa8\x21\x65\xd1\x0e\x04\xc8\x32\x94\x11\x03\x98\x0b\xa0\xeb\xeb\x3d\x4a\x6b\x65\xa4\xf4\x5c\xeb\xf5\x7b\x01\xcd\x01\x67\xdf\x67\x70\x3d\x79\x07\xfa\x02\x4e\x3c\x88\x10\x29\x76\x5b\xed\x28\xe1\xbb\x59\xb1\x91\x41\x8b\xc4\x27\x7f\x7c\x1c\x41\x32\xec\x3f\x36\x21\x32\x18\x1e\xc7\xfc\xc5\x97\xdb\xd1\xcb\x13\x92\x34\x05\x36\x90\x5c\x68\x23\xef\xc0\x5e\x6b\xa6\xfa\x05\xa7\xa8\xaf\xdb\x93\xd2\x87\xd3\x50\x7c\xa4\xa7\xe0\x7c\x8a\xf5\x01\xc7\xa9\xdd\xb6\x00\xc3\xd5\x7c\xa2\x99\x2a\x74\xdc\x89\x0e\xbc\xff\xfc\x4c\xfb\xee\x01\xb9\x43\xef\xbe\xfe\x71\xa8\x2b\x31\x40\x49\xca\x92\x24\xe9\xfd\x8e\x8f\x19\x5c\x7b\x2b\xbe\x27\xcf\x6d\xc1\xc4\xd1\x54\xd3\xcb\xf5\x33\x08\x74\x33\x29\x41\x1a\x34\xf9\x35\x83\x2c\x91\x00\x19\xe2\xc5\xee\x2c\xc3\x97\x50\x53\xa7\x2e\xa2\x99\x2e\x54\xa1\x1d\x5b\xb5\x6f\xdf\x90\x25\x44\x96\x9a\xae\x23\x6f\x0b\x68\xaf\x11\x71\xbd\x81\xef\x58\x88\x3b\x05\x2e\xa2\x39\xc8\x72\xba\xfd\x56\x73\x10\x77\x0a\x11\x45\xb3\x1d\x17\xd1\x5c\x68\x20\x9a\xe9\x7f\x23\x59\xc6\xdc\x72\x34\x17\x7a\xb2\xcc\x40\xd6\x9e\x70\x03\xe0\xdb\x2e\x8d\xaf\x9f\x62\xcb\x98\x98\x64\x7a\x4b\xb8\xf1\x5c\xc6\x62\x05\x65\x4f\x90\x9e\x54\xbf\xd0\xdc\xd7\xb0\xd7\xd1\x1b\x13\x69\xa2\x48\x19\x97\x8c\x2c\x92\x8a\x7b\x60\x1c\x6b\x61\x4b\x97\x41\xda\xe4\x9c\x3e\xc5\x41\x99\x2f\x75\xbe\xe7\x52\xb6\xbd\x84\x08\x4e\x7e\x4a\xd1\xb9\xa3\xba\xb6\x73\xe8\x09\x6a\x46\xd1\xd9\x6c\x37\x7c\x4b\x10\x22\x6a\xaa\x66\xba\xd9\xa6\x04\x6f\xea\xd3\x35\x20\x6a\xba\xe6\x6a\xd0\x39\x67\xf6\xe6\x3d\x80\x17\x4f\x0f\xf6\xd6\x13\x73\x61\x88\xd0\x3e\x67\xaa\xb9\x30\x26\xce\x42\x84\xa6\x6b\x7b\x48\x93\x6d\x25\xf9\xd2\x4c\x45\x0f\x4a\xe3\x32\x74\x5c\xcd\x0c\xd6\xed\x72\xa9\x2b\x3a\x50\xcf\xa3\x60\x6a\x19\x70\x22\x5b\x06\xd0\x92\xf0\x12\x78\x36\xbc\x06\x70\xbc\xd8\x17\x7a\x0b\xc7\x00\xde\x5a\x64\x93\x9e\x3b\xb5\xa1\x33\xf5\x76\x38\xba\xb5\xbc\x74\xaa\x01\x65\x6d\x61\x5c\x3a\x7b\xaa\xa9\xd3\xf3\xe6\xfa\x91\xc3\xb0\x64\x4d\xd1\xa0\xbc\xe9\xcc\x89\x8b\xfd\x53\xba\xcb\x97\x81\x0b\x42\x1b\xfc\xf6\x6d\x73\x72\xe3\x45\x0d\xcd\x41\x00\xd2\xf0\x3f\xd7\xe1\x1a\x31\x80\xed\x4c\x81\x0e\x65\x64\xe1\x68\xa6\x8a\x34\x83\xcf\x79\xcd\x04\xf6\x7a\x33\x1d\x98\x32\xe2\x25\xa6\x34\xf9\x0d\x9a\xde\x46\xce\x1b\x0d\x65\xc4\xb5\x10\xd1\xb2\x1c\x17\x99\x43\x5b\xb1\x0c\xdf\x1c\x2d\x05\x71\x2c\x03\xfa\xfe\x5a\x83\xce\xf7\x53\xbe\x36\x42\xda\xa1\x76\x60\x14\x7a\x46\x20\xbf\x89\x5b\xf1\x2f\x13\x18\x49\xf9\x00\x4d\x9e\x01\x23\x2d\xa9\xe0\xa2\x2c\x79\xd2\x8d\x49\x96\x26\x11\x71\xed\x86\x49\xe3\x31\xc1\x25\x69\x88\x97\x2c\x64\xa6\x70\x2f\xc6\xed\xd6\xc1\x0f\x6f\xfb\x7e\x9e\x60\x63\x5f\x50\xe4\x7e\xd2\xbb\x75\xfb\x7e\x28\xda\x78\xba\x7d\xb5\xfd\x23\xc3\x0c\x57\x33\x36\x1e\x3d\xa0\xa1\xc0\xb7\xbf\x91\x68\x10\xde\x65\x64\x0e\xd6\xba\x05\x64\xc4\x71\xed\x19\x5c\x3b\x88\x04\x4c\x44\x84\x08\x46\x53\x3b\x41\x3b\x88\x6e\x99\xea\x03\xe2\x40\xe8\x01\x08\x86\xe6\x3c\xf7\xf3\x5d\xb5\x1e\x0d\xb0\x2a\x05\x82\xee\x69\x1f\xf0\x3b\x92\x5f\xb8\xc8\x12\xde\xe9\xba\xa7\xd1\x7e\xd2\x82\x4c\xa1\x0d\x1f\xbc\xfc\x62\x09\x11\xd9\x32\xef\x5c\xc4\x84\xbe\xb2\x07\xe9\xf4\xeb\xc2\x4f\x2d\x90\xff\x07\xdf\xa1\x8d\x00\x15\x68\xe6\xff\xfb\x9e\xc8\xda\x26\xef\x0a\x32\x3a\x7f\x40\xa1\xd5\x18\x34\x85\x4d\xb6\xd2\x1f\xb7\x4b\x3e\xce\xb8\xbc\x29\x6a\xdf\xac\xdd\x95\xb3\x10\x27\x36\x74\x16\xfa\x89\xd0\xea\x5f\x07\x8d\x83\x1b\x8d\x0c\xa3\x79\x44\x8d\xc3\x8a\xda\x49\x5d\x49\xe9\x48\x8c\x80\x3c\x09\xc2\x5d\x85\x1c\xc4\xbe\xf6\x12\x45\xcf\x0e\x1c\x68\x6b\x40\xd7\x3e\xa0\xbc\xc9\x4c\xbe\xf7\x77\xf8\x4e\x41\x77\x16\xa2\xa1\xb9\x6e\x70\x80\x15\x81\xae\x19\xd0\x71\x81\x31\xdf\x71\x5c\x2c\x95\xf9\x41\xc3\xb3\x93\xd1\x97\xaf\xa9\x2e\x74\xa2\x68\xba\x17\x71\xec\x85\x0e\xb3\x65\xce\xde\x05\x4d\x20\x7a\xce\x54\xb4\x2c\x7d\x87\x51\x86\x0a\xf0\xf8\x0e\xde\x9e\x92\x11\xd4\x72\xaa\xb9\x50\xd7\x1c\x77\x23\xe4\x3f\xff\x3a\x67\x4f\xe3\x5f\x7b\x3e\x22\x9e\x71\x24\xb0\xee\xef\x2c\x2f\x60\xfc\x66\x6c\x5f\xcf\xf4\x69\x96\xbf\x7d\x43\x34\xd3\x81\xb6\xeb\x6f\x0c\x36\x44\xca\x9a\x13\xf0\xe0\xb8\xc0\x85\xfe\x1b\xc6\x20\x90\xa6\x88\xb3\x98\xfb\x87\x6f\x32\x12\xc8\x05\xd1\x8c\xb9\x0e\x0d\x68\xba\xbe\xa9\xee\x6d\x09\x13\x55\x67\xb3\x2f\x0c\x5f\x9d\x73\xf7\xf7\x7f\xee\x1e\x90\xf8\x43\xa5\x09\x92\x4f\x9d\xb7\x37\x71\xcf\x33\x7c\xda\xcc\xf1\x25\x75\x83\x97\x95\xf9\x70\x76\xb2\xbf\xfb\x1b\xf9\xdc\x5f\x75\x7d\x64\x9f\x1f\x91\xcf\xdb\x07\xc9\x32\xbc\xec\xea\x33\xf2\x9f\x10\xde\xde\x53\xa7\xec\x23\xce\x3e\x92\xcc\x77\x94\xc0\x49\x8e\xbe\x47\xfd\xd7\x20\x67\xe6\xf0\xfa\xf7\x0a\x65\xe6\xf0\xf4\x7b\x01\xce\xe2\x30\x28\x52\xb5\x83\x96\xf2\x5e\xa7\x81\x78\x09\x9b\x97\x09\x20\xf2\xc2\x98\xfb\xdb\x55\x1d\xba\xd0\xaf\x2e\xfd\x7f\x01\x00\x00\xff\xff\x69\x66\x1f\x6e\x80\xe8\x00\x00") func failed_transactionsHorizonSqlBytes() ([]byte, error) { return bindataRead( @@ -206,7 +206,7 @@ func failed_transactionsHorizonSql() (*asset, error) { } info := bindataFileInfo{name: "failed_transactions-horizon.sql", size: 0, mode: os.FileMode(0), modTime: time.Unix(0, 0)} - a := &asset{bytes: bytes, info: info, digest: [32]uint8{0x69, 0x1f, 0x40, 0x24, 0x26, 0x90, 0xc1, 0xcf, 0x7a, 0x85, 0x79, 0x9d, 0x1e, 0xd4, 0xa0, 0xbf, 0x25, 0x47, 0x93, 0x75, 0xb0, 0x6, 0xd4, 0xd9, 0x21, 0x2c, 0x6f, 0x63, 0x7f, 0x39, 0xf5, 0xd0}} + a := &asset{bytes: bytes, info: info, digest: [32]uint8{0x67, 0xf, 0x72, 0x65, 0xb7, 0x77, 0xde, 0x35, 0x8a, 0x5b, 0xcc, 0x5c, 0x89, 0x85, 0x66, 0xac, 0xb6, 0x80, 0xd7, 0x70, 0x6a, 0xc9, 0x20, 0x38, 0x42, 0xb7, 0x6d, 0x48, 0x62, 0x20, 0x1d, 0x77}} return a, nil } diff --git a/services/horizon/internal/test/scenarios/failed_transactions-horizon.sql b/services/horizon/internal/test/scenarios/failed_transactions-horizon.sql index be37733aef..7144490218 100644 --- a/services/horizon/internal/test/scenarios/failed_transactions-horizon.sql +++ b/services/horizon/internal/test/scenarios/failed_transactions-horizon.sql @@ -508,7 +508,13 @@ INSERT INTO gorp_migrations VALUES ('15_ledger_failed_txs.sql', '2019-06-03 18:2 INSERT INTO gorp_migrations VALUES ('16_ingest_failed_transactions.sql', '2019-06-03 18:28:47.117989+02'); INSERT INTO gorp_migrations VALUES ('17_transaction_fee_paid.sql', '2019-06-03 18:28:47.120034+02'); INSERT INTO gorp_migrations VALUES ('18_account_for_signers.sql', '2019-10-31 14:19:49.123835+01'); - +INSERT INTO gorp_migrations VALUES ('24_accounts.sql', '2019-10-31 14:19:49.123835+01'); +INSERT INTO gorp_migrations VALUES ('34_fee_bump_transactions.sql', '2019-10-31 14:19:49.123835+01'); +INSERT INTO gorp_migrations VALUES ('37_add_tx_set_operation_count_to_ledgers.sql', '2019-10-31 14:19:49.123835+01'); +INSERT INTO gorp_migrations VALUES ('46_add_muxed_accounts.sql', '2019-10-31 14:19:49.123835+01'); +INSERT INTO gorp_migrations VALUES ('53_add_trades_rounding_slippage.sql', '2019-10-31 14:19:49.123835+01'); +INSERT INTO gorp_migrations VALUES ('54_tx_preconditions_and_account_fields.sql', '2019-10-31 14:19:49.123835+01'); +INSERT INTO gorp_migrations VALUES ('55_filter_rules.sql', '2019-10-31 14:19:49.123835+01'); -- -- Data for Name: history_accounts; Type: TABLE DATA; Schema: public; Owner: - @@ -1039,6 +1045,88 @@ ALTER TABLE history_transactions ADD account_muxed varchar(69) NULL, ADD fee_acc ALTER TABLE history_operations ADD source_account_muxed varchar(69) NULL; ALTER TABLE history_effects ADD address_muxed varchar(69) NULL; +-- migration 24 + + +CREATE TABLE accounts ( + account_id character varying(56) NOT NULL, + balance bigint NOT NULL, + buying_liabilities bigint NOT NULL, + selling_liabilities bigint NOT NULL, + sequence_number bigint NOT NULL, + num_subentries integer NOT NULL, + inflation_destination character varying(56) NOT NULL, + flags integer NOT NULL, + home_domain character varying(32) NOT NULL, + master_weight smallint NOT NULL, + threshold_low smallint NOT NULL, + threshold_medium smallint NOT NULL, + threshold_high smallint NOT NULL, + last_modified_ledger integer NOT NULL +); + +CREATE TABLE accounts_data ( + -- ledger_key is a LedgerKey marshaled using MarshalBinary + -- and base64-encoded used to boost perfomance of some queries. + ledger_key character varying(150) NOT NULL, + account_id character varying(56) NOT NULL, + name character varying(64) NOT NULL, + value character varying(90) NOT NULL, -- base64-encoded 64 bytes + last_modified_ledger INT NOT NULL, + PRIMARY KEY (ledger_key) +); + +-- migration 38 + +-- migration 54 + +ALTER TABLE accounts ADD sequence_ledger integer; +ALTER TABLE accounts ADD sequence_time bigint; + +-- CAP-40 signed payload strkeys can be 165 characters long, see +-- strkey/main.go:maxEncodedSize. But we'll use text here, so we don't need to +-- adjust it *ever again*. +ALTER TABLE accounts_signers + ALTER COLUMN signer TYPE text; + +-- migration 55 +CREATE TABLE txsub_results ( + transaction_hash varchar(64) NOT NULL UNIQUE, + inner_transaction_hash varchar(64), + tx_result text, -- serialized history.Transaction + submitted_at timestamp NOT NULL DEFAULT NOW() +); + +CREATE TABLE account_filter_rules ( + enabled bool NOT NULL default false, + whitelist varchar[] NOT NULL, + last_modified bigint NOT NULL +); + +CREATE TABLE asset_filter_rules ( + enabled bool NOT NULL default false, + whitelist varchar[] NOT NULL, + last_modified bigint NOT NULL +); + +-- insert the default disabled state for each supported filter implementation +INSERT INTO account_filter_rules VALUES (false, '{}', 0); +INSERT INTO asset_filter_rules VALUES (false, '{}', 0); + +INSERT INTO txsub_results +VALUES ( + 'aa168f12124b7c196c0adaee7c73a64d37f99428cacb59a91ff389626845e7cf', + NULL, + '{ "TxResult": "AAAAAAAAAGT/////AAAAAQAAAAAAAAAB/////gAAAAA=" }', + '2019-06-03 18:28:47.032496+02'); + +INSERT INTO txsub_results +VALUES ( + '56e3216045d579bea40f2d35a09406de3a894ecb5be70dbda5ec9c0427a0d5a1', + NULL, + '{ "TxResult": "AAAAAAAAAGQAAAAAAAAAAQAAAAAAAAABAAAAAAAAAAA=" }', + '2019-06-03 18:28:47.032496+02'); + -- -- PostgreSQL database dump complete -- diff --git a/services/horizon/internal/txsub/helpers_test.go b/services/horizon/internal/txsub/helpers_test.go index 119515ebc2..bc71f83e51 100644 --- a/services/horizon/internal/txsub/helpers_test.go +++ b/services/horizon/internal/txsub/helpers_test.go @@ -28,6 +28,7 @@ func (sub *MockSubmitter) Submit(ctx context.Context, env string) SubmissionResu type mockDBQ struct { mock.Mock + history.MockQTxSubmissionResult } func (m *mockDBQ) BeginTx(txOpts *sql.TxOptions) error { @@ -35,6 +36,11 @@ func (m *mockDBQ) BeginTx(txOpts *sql.TxOptions) error { return args.Error(0) } +func (m *mockDBQ) Commit() error { + args := m.Called() + return args.Error(0) +} + func (m *mockDBQ) Rollback() error { args := m.Called() return args.Error(0) @@ -45,16 +51,16 @@ func (m *mockDBQ) NoRows(err error) bool { return args.Bool(0) } -func (m *mockDBQ) GetLatestHistoryLedger(ctx context.Context) (uint32, error) { - args := m.Called() - return args.Get(0).(uint32), args.Error(1) -} - func (m *mockDBQ) GetSequenceNumbers(ctx context.Context, addresses []string) (map[string]uint64, error) { args := m.Called(ctx, addresses) return args.Get(0).(map[string]uint64), args.Error(1) } +func (m *mockDBQ) GetLatestHistoryLedger(ctx context.Context) (uint32, error) { + args := m.Called() + return args.Get(0).(uint32), args.Error(1) +} + func (m *mockDBQ) TransactionsByHashesSinceLedger(ctx context.Context, hashes []string, sinceLedgerSeq uint32) ([]history.Transaction, error) { args := m.Called(ctx, hashes, sinceLedgerSeq) if args.Get(0) == nil { @@ -62,8 +68,3 @@ func (m *mockDBQ) TransactionsByHashesSinceLedger(ctx context.Context, hashes [] } return args.Get(0).([]history.Transaction), args.Error(1) } - -func (m *mockDBQ) TransactionByHash(ctx context.Context, dest interface{}, hash string) error { - args := m.Called(ctx, dest, hash) - return args.Error(0) -} diff --git a/services/horizon/internal/txsub/results.go b/services/horizon/internal/txsub/results.go index 575261d061..e9f0f29463 100644 --- a/services/horizon/internal/txsub/results.go +++ b/services/horizon/internal/txsub/results.go @@ -10,19 +10,15 @@ import ( ) func txResultByHash(ctx context.Context, db HorizonDB, hash string) (history.Transaction, error) { - // query history database - var hr history.Transaction - err := db.TransactionByHash(ctx, &hr, hash) - if err == nil { - return txResultFromHistory(hr) - } - - if !db.NoRows(err) { - return hr, errors.Wrap(err, "could not lookup transaction by hash") + hr, err := db.GetTxSubmissionResult(ctx, hash) + if err != nil { + if db.NoRows(err) { + return history.Transaction{}, ErrNoResults + } + return history.Transaction{}, errors.Wrap(err, "could not lookup transaction by hash") } - // if no result was found in either db, return ErrNoResults - return hr, ErrNoResults + return txResultFromHistory(hr) } func txResultFromHistory(tx history.Transaction) (history.Transaction, error) { diff --git a/services/horizon/internal/txsub/results_test.go b/services/horizon/internal/txsub/results_test.go index 2a04d7ecdd..7c927905b4 100644 --- a/services/horizon/internal/txsub/results_test.go +++ b/services/horizon/internal/txsub/results_test.go @@ -7,28 +7,6 @@ import ( "github.com/stellar/go/services/horizon/internal/test" ) -func TestGetIngestedTx(t *testing.T) { - tt := test.Start(t) - tt.Scenario("base") - defer tt.Finish() - q := &history.Q{SessionInterface: tt.HorizonSession()} - hash := "2374e99349b9ef7dba9a5db3339b78fda8f34777b1af33ba468ad5c0df946d4d" - tx, err := txResultByHash(tt.Ctx, q, hash) - tt.Assert.NoError(err) - tt.Assert.Equal(hash, tx.TransactionHash) -} - -func TestGetIngestedTxHashes(t *testing.T) { - tt := test.Start(t) - tt.Scenario("base") - defer tt.Finish() - q := &history.Q{SessionInterface: tt.HorizonSession()} - hashes := []string{"2374e99349b9ef7dba9a5db3339b78fda8f34777b1af33ba468ad5c0df946d4d"} - txs, err := q.TransactionsByHashesSinceLedger(tt.Ctx, hashes, 0) - tt.Assert.NoError(err) - tt.Assert.Equal(hashes[0], txs[0].TransactionHash) -} - func TestGetMissingTx(t *testing.T) { tt := test.Start(t) tt.Scenario("base") diff --git a/services/horizon/internal/txsub/system.go b/services/horizon/internal/txsub/system.go index 3b47c054c0..c75a83aca6 100644 --- a/services/horizon/internal/txsub/system.go +++ b/services/horizon/internal/txsub/system.go @@ -15,13 +15,14 @@ import ( ) type HorizonDB interface { - GetLatestHistoryLedger(ctx context.Context) (uint32, error) - TransactionByHash(ctx context.Context, dest interface{}, hash string) error - TransactionsByHashesSinceLedger(ctx context.Context, hashes []string, sinceLedgerSeq uint32) ([]history.Transaction, error) + history.QTxSubmissionResult GetSequenceNumbers(ctx context.Context, addresses []string) (map[string]uint64, error) BeginTx(*sql.TxOptions) error + Commit() error Rollback() error NoRows(error) bool + GetLatestHistoryLedger(ctx context.Context) (uint32, error) + TransactionsByHashesSinceLedger(ctx context.Context, hashes []string, sinceLedgerSeq uint32) ([]history.Transaction, error) } // System represents a completely configured transaction submission system. @@ -35,12 +36,14 @@ type System struct { accountSeqPollInterval time.Duration - DB func(context.Context) HorizonDB - Pending OpenSubmissionList - Submitter Submitter - SubmissionQueue *sequence.Manager - SubmissionTimeout time.Duration - Log *log.Entry + DB func(context.Context) HorizonDB + Pending OpenSubmissionList + Submitter Submitter + SubmissionQueue *sequence.Manager + SubmissionTimeout time.Duration + SubmissionResultTTL time.Duration + lastSubResultCleanup time.Time + Log *log.Entry Metrics struct { // SubmissionDuration exposes timing metrics about the rate and latency of @@ -96,6 +99,7 @@ func (sys *System) Submit( rawTx string, envelope xdr.TransactionEnvelope, hash string, + innerHash string, ) (resultReadCh <-chan Result) { sys.Init() resultCh := make(chan Result, 1) @@ -149,7 +153,7 @@ func (sys *System) Submit( }) select { - case err := <-submissionWait: + case err = <-submissionWait: if err == sequence.ErrBadSequence { // convert the internal only ErrBadSequence into the FailedTransactionError err = ErrBadSequence @@ -160,6 +164,11 @@ func (sys *System) Submit( return } + // initialize row where to wait for results + if err := db.InitEmptyTxSubmissionResult(ctx, hash, innerHash); err != nil { + sys.finish(ctx, hash, resultCh, Result{Err: err}) + return + } sr := sys.submitOnce(ctx, rawTx) sys.updateTransactionTypeMetrics(envelope) @@ -298,6 +307,27 @@ func (sys *System) unsetTickInProgress() { sys.tickInProgress = false } +func (sys *System) getHistoricalTXs(db HorizonDB, ctx context.Context, pending []string, ledgerBackwards int32) ([]history.Transaction, error) { + logger := log.Ctx(ctx) + latestLedger, err := db.GetLatestHistoryLedger(ctx) + if err != nil { + logger.WithError(err).Error("error getting latest history ledger") + return nil, err + } + + sinceLedgerSeq := int32(latestLedger) - ledgerBackwards + if sinceLedgerSeq < 0 { + sinceLedgerSeq = 0 + } + + txs, err := db.TransactionsByHashesSinceLedger(ctx, pending, uint32(sinceLedgerSeq)) + if err != nil && !db.NoRows(err) { + logger.WithError(err).Error("error getting transactions by hashes") + return nil, err + } + return txs, nil +} + // Tick triggers the system to update itself with any new data available. func (sys *System) Tick(ctx context.Context) { sys.Init() @@ -317,13 +347,14 @@ func (sys *System) Tick(ctx context.Context) { db := sys.DB(ctx) options := &sql.TxOptions{ Isolation: sql.LevelRepeatableRead, - ReadOnly: true, + // we need to delete old transaction submission entries + ReadOnly: false, } if err := db.BeginTx(options); err != nil { logger.WithError(err).Error("could not start repeatable read transaction for txsub tick") return } - defer db.Rollback() + defer db.Commit() addys := sys.SubmissionQueue.Addresses() if len(addys) > 0 { @@ -339,24 +370,19 @@ func (sys *System) Tick(ctx context.Context) { pending := sys.Pending.Pending(ctx) if len(pending) > 0 { - latestLedger, err := db.GetLatestHistoryLedger(ctx) - if err != nil { - logger.WithError(err).Error("error getting latest history ledger") + txs, err := db.GetTxSubmissionResults(ctx, pending) + if err != nil && !db.NoRows(err) { + logger.WithError(err).Error("error getting transactions by hashes") return } // In Tick we only check txs in a queue so those which did not have results before Tick - // so we check for them in the last 5 mins of ledgers: 60. - sinceLedgerSeq := int32(latestLedger) - 60 - if sinceLedgerSeq < 0 { - sinceLedgerSeq = 0 - } - - txs, err := db.TransactionsByHashesSinceLedger(ctx, pending, uint32(sinceLedgerSeq)) - if err != nil && !db.NoRows(err) { - logger.WithError(err).Error("error getting transactions by hashes") + // so we include the last 5 mins of ledgers also: 60. + historyTxs, err := sys.getHistoricalTXs(db, ctx, pending, 60) + if err != nil { return } + txs = append(txs, historyTxs...) txMap := make(map[string]history.Transaction, len(txs)) for _, tx := range txs { @@ -391,6 +417,16 @@ func (sys *System) Tick(ctx context.Context) { } } + // Wait at least SubmissionResultTTL between cleanups + if time.Since(sys.lastSubResultCleanup) > sys.SubmissionResultTTL { + sys.lastSubResultCleanup = time.Now() + ttlInSeconds := uint64(sys.SubmissionResultTTL / time.Second) + if _, err := db.DeleteTxSubmissionResultsOlderThan(ctx, ttlInSeconds); err != nil { + logger.WithStack(err).Error(err) + return + } + } + stillOpen, err := sys.Pending.Clean(ctx, sys.SubmissionTimeout) if err != nil { logger.WithStack(err).Error(err) @@ -443,6 +479,10 @@ func (sys *System) Init() { // by sending a Timeout response. sys.SubmissionTimeout = 30 * time.Second } + + if sys.SubmissionResultTTL == 0 { + sys.SubmissionResultTTL = 5 * time.Minute + } }) } diff --git a/services/horizon/internal/txsub/system_test.go b/services/horizon/internal/txsub/system_test.go index acaf6746fa..7204e78b9f 100644 --- a/services/horizon/internal/txsub/system_test.go +++ b/services/horizon/internal/txsub/system_test.go @@ -129,26 +129,16 @@ func (suite *SystemTestSuite) TestSubmit_Basic() { ReadOnly: true, }).Return(nil).Once() suite.db.On("Rollback").Return(nil).Once() - suite.db.On("TransactionByHash", suite.ctx, mock.Anything, suite.successTx.Transaction.TransactionHash). - Run(func(args mock.Arguments) { - ptr := args.Get(1).(*history.Transaction) - *ptr = suite.successTx.Transaction - }). - Return(nil).Once() - - r := <-suite.system.Submit( - suite.ctx, - suite.successTx.Transaction.TxEnvelope, - suite.successXDR, - suite.successTx.Transaction.TransactionHash, - ) + suite.db.MockQTxSubmissionResult.On("GetTxSubmissionResult", suite.ctx, suite.successTx.Transaction.TransactionHash). + Return(suite.successTx.Transaction, nil).Once() + r := <-suite.system.Submit(suite.ctx, suite.successTx.Transaction.TxEnvelope, suite.successXDR, suite.successTx.Transaction.TransactionHash, "") assert.Nil(suite.T(), r.Err) assert.Equal(suite.T(), suite.successTx, r) assert.False(suite.T(), suite.submitter.WasSubmittedTo) } -func (suite *SystemTestSuite) TestTimeoutDuringSequnceLoop() { +func (suite *SystemTestSuite) TestTimeoutDuringSequenceLoop() { var cancel context.CancelFunc suite.ctx, cancel = context.WithTimeout(suite.ctx, time.Duration(0)) defer cancel() @@ -159,24 +149,20 @@ func (suite *SystemTestSuite) TestTimeoutDuringSequnceLoop() { ReadOnly: true, }).Return(nil).Once() suite.db.On("Rollback").Return(nil).Once() - suite.db.On("TransactionByHash", suite.ctx, mock.Anything, suite.successTx.Transaction.TransactionHash). - Return(sql.ErrNoRows).Once() + suite.db.MockQTxSubmissionResult.On("GetTxSubmissionResult", suite.ctx, suite.successTx.Transaction.TransactionHash). + Return(history.Transaction{}, sql.ErrNoRows).Once() suite.db.On("NoRows", sql.ErrNoRows).Return(true).Once() suite.db.On("GetSequenceNumbers", suite.ctx, []string{suite.unmuxedSource.Address()}). Return(map[string]uint64{suite.unmuxedSource.Address(): 0}, nil) - - r := <-suite.system.Submit( - suite.ctx, - suite.successTx.Transaction.TxEnvelope, - suite.successXDR, - suite.successTx.Transaction.TransactionHash, - ) + suite.db.MockQTxSubmissionResult.On("InitEmptyTxSubmissionResult", suite.ctx, suite.successTx.Transaction.TransactionHash, ""). + Return(nil).Once() + r := <-suite.system.Submit(suite.ctx, suite.successTx.Transaction.TxEnvelope, suite.successXDR, suite.successTx.Transaction.TransactionHash, "") assert.NotNil(suite.T(), r.Err) assert.Equal(suite.T(), ErrTimeout, r.Err) } -func (suite *SystemTestSuite) TestClientDisconnectedDuringSequnceLoop() { +func (suite *SystemTestSuite) TestClientDisconnectedDuringSequenceLoop() { var cancel context.CancelFunc suite.ctx, cancel = context.WithCancel(suite.ctx) @@ -186,8 +172,8 @@ func (suite *SystemTestSuite) TestClientDisconnectedDuringSequnceLoop() { ReadOnly: true, }).Return(nil).Once() suite.db.On("Rollback").Return(nil).Once() - suite.db.On("TransactionByHash", suite.ctx, mock.Anything, suite.successTx.Transaction.TransactionHash). - Return(sql.ErrNoRows).Once() + suite.db.MockQTxSubmissionResult.On("GetTxSubmissionResult", suite.ctx, suite.successTx.Transaction.TransactionHash). + Return(history.Transaction{}, sql.ErrNoRows).Once() suite.db.On("NoRows", sql.ErrNoRows).Return(true).Once() suite.db.On("GetSequenceNumbers", suite.ctx, []string{suite.unmuxedSource.Address()}). Return(map[string]uint64{suite.unmuxedSource.Address(): 0}, nil). @@ -199,13 +185,9 @@ func (suite *SystemTestSuite) TestClientDisconnectedDuringSequnceLoop() { Once() suite.db.On("GetSequenceNumbers", suite.ctx, []string{suite.unmuxedSource.Address()}). Return(map[string]uint64{suite.unmuxedSource.Address(): 0}, nil) - - r := <-suite.system.Submit( - suite.ctx, - suite.successTx.Transaction.TxEnvelope, - suite.successXDR, - suite.successTx.Transaction.TransactionHash, - ) + suite.db.MockQTxSubmissionResult.On("InitEmptyTxSubmissionResult", suite.ctx, suite.successTx.Transaction.TransactionHash, ""). + Return(nil).Once() + r := <-suite.system.Submit(suite.ctx, suite.successTx.Transaction.TxEnvelope, suite.successXDR, suite.successTx.Transaction.TransactionHash, "") assert.NotNil(suite.T(), r.Err) assert.Equal(suite.T(), ErrCanceled, r.Err) @@ -227,20 +209,17 @@ func (suite *SystemTestSuite) TestSubmit_NotFoundError() { ReadOnly: true, }).Return(nil).Once() suite.db.On("Rollback").Return(nil).Once() - suite.db.On("TransactionByHash", suite.ctx, mock.Anything, suite.successTx.Transaction.TransactionHash). - Return(sql.ErrNoRows).Once() + suite.db.MockQTxSubmissionResult.On("GetTxSubmissionResult", suite.ctx, suite.successTx.Transaction.TransactionHash). + Return(history.Transaction{}, sql.ErrNoRows).Once() suite.db.On("NoRows", sql.ErrNoRows).Return(true).Once() suite.db.On("GetSequenceNumbers", suite.ctx, []string{suite.unmuxedSource.Address()}). Return(map[string]uint64{suite.unmuxedSource.Address(): 0}, nil). Once() + suite.db.MockQTxSubmissionResult.On("InitEmptyTxSubmissionResult", suite.ctx, suite.successTx.Transaction.TransactionHash, ""). + Return(nil).Once() suite.submitter.R.Err = errors.New("busted for some reason") - r := <-suite.system.Submit( - suite.ctx, - suite.successTx.Transaction.TxEnvelope, - suite.successXDR, - suite.successTx.Transaction.TransactionHash, - ) + r := <-suite.system.Submit(suite.ctx, suite.successTx.Transaction.TxEnvelope, suite.successXDR, suite.successTx.Transaction.TransactionHash, "") assert.NotNil(suite.T(), r.Err) assert.True(suite.T(), suite.submitter.WasSubmittedTo) @@ -257,8 +236,8 @@ func (suite *SystemTestSuite) TestSubmit_BadSeq() { ReadOnly: true, }).Return(nil).Once() suite.db.On("Rollback").Return(nil).Once() - suite.db.On("TransactionByHash", suite.ctx, mock.Anything, suite.successTx.Transaction.TransactionHash). - Return(sql.ErrNoRows).Once() + suite.db.MockQTxSubmissionResult.On("GetTxSubmissionResult", suite.ctx, suite.successTx.Transaction.TransactionHash). + Return(history.Transaction{}, sql.ErrNoRows).Once() suite.db.On("NoRows", sql.ErrNoRows).Return(true).Once() suite.db.On("GetSequenceNumbers", suite.ctx, []string{suite.unmuxedSource.Address()}). Return(map[string]uint64{suite.unmuxedSource.Address(): 0}, nil). @@ -266,19 +245,12 @@ func (suite *SystemTestSuite) TestSubmit_BadSeq() { suite.db.On("GetSequenceNumbers", suite.ctx, []string{suite.unmuxedSource.Address()}). Return(map[string]uint64{suite.unmuxedSource.Address(): 1}, nil). Once() - suite.db.On("TransactionByHash", suite.ctx, mock.Anything, suite.successTx.Transaction.TransactionHash). - Run(func(args mock.Arguments) { - ptr := args.Get(1).(*history.Transaction) - *ptr = suite.successTx.Transaction - }). + suite.db.MockQTxSubmissionResult.On("GetTxSubmissionResult", suite.ctx, suite.successTx.Transaction.TransactionHash). + Return(suite.successTx.Transaction, nil).Once() + suite.db.MockQTxSubmissionResult.On("InitEmptyTxSubmissionResult", suite.ctx, suite.successTx.Transaction.TransactionHash, ""). Return(nil).Once() - r := <-suite.system.Submit( - suite.ctx, - suite.successTx.Transaction.TxEnvelope, - suite.successXDR, - suite.successTx.Transaction.TransactionHash, - ) + r := <-suite.system.Submit(suite.ctx, suite.successTx.Transaction.TxEnvelope, suite.successXDR, suite.successTx.Transaction.TransactionHash, "") assert.Nil(suite.T(), r.Err) assert.Equal(suite.T(), suite.successTx, r) @@ -293,8 +265,8 @@ func (suite *SystemTestSuite) TestSubmit_BadSeqNotFound() { ReadOnly: true, }).Return(nil).Once() suite.db.On("Rollback").Return(nil).Once() - suite.db.On("TransactionByHash", suite.ctx, mock.Anything, suite.successTx.Transaction.TransactionHash). - Return(sql.ErrNoRows).Twice() + suite.db.MockQTxSubmissionResult.On("GetTxSubmissionResult", suite.ctx, suite.successTx.Transaction.TransactionHash). + Return(history.Transaction{}, sql.ErrNoRows).Twice() suite.db.On("NoRows", sql.ErrNoRows).Return(true).Twice() suite.db.On("GetSequenceNumbers", suite.ctx, []string{suite.unmuxedSource.Address()}). Return(map[string]uint64{suite.unmuxedSource.Address(): 0}, nil). @@ -302,17 +274,14 @@ func (suite *SystemTestSuite) TestSubmit_BadSeqNotFound() { suite.db.On("GetSequenceNumbers", suite.ctx, []string{suite.unmuxedSource.Address()}). Return(map[string]uint64{suite.unmuxedSource.Address(): 1}, nil). Once() + suite.db.MockQTxSubmissionResult.On("InitEmptyTxSubmissionResult", suite.ctx, suite.successTx.Transaction.TransactionHash, ""). + Return(nil).Once() // set poll interval to 1ms so we don't need to wait 3 seconds for the test to complete suite.system.Init() suite.system.accountSeqPollInterval = time.Millisecond - r := <-suite.system.Submit( - suite.ctx, - suite.successTx.Transaction.TxEnvelope, - suite.successXDR, - suite.successTx.Transaction.TransactionHash, - ) + r := <-suite.system.Submit(suite.ctx, suite.successTx.Transaction.TxEnvelope, suite.successXDR, suite.successTx.Transaction.TransactionHash, "") assert.NotNil(suite.T(), r.Err) assert.True(suite.T(), suite.submitter.WasSubmittedTo) @@ -325,19 +294,16 @@ func (suite *SystemTestSuite) TestSubmit_OpenTransactionList() { ReadOnly: true, }).Return(nil).Once() suite.db.On("Rollback").Return(nil).Once() - suite.db.On("TransactionByHash", suite.ctx, mock.Anything, suite.successTx.Transaction.TransactionHash). - Return(sql.ErrNoRows).Once() + suite.db.MockQTxSubmissionResult.On("GetTxSubmissionResult", suite.ctx, suite.successTx.Transaction.TransactionHash). + Return(history.Transaction{}, sql.ErrNoRows).Once() suite.db.On("NoRows", sql.ErrNoRows).Return(true).Once() suite.db.On("GetSequenceNumbers", suite.ctx, []string{suite.unmuxedSource.Address()}). Return(map[string]uint64{suite.unmuxedSource.Address(): 0}, nil). Once() + suite.db.MockQTxSubmissionResult.On("InitEmptyTxSubmissionResult", suite.ctx, suite.successTx.Transaction.TransactionHash, ""). + Return(nil).Once() - suite.system.Submit( - suite.ctx, - suite.successTx.Transaction.TxEnvelope, - suite.successXDR, - suite.successTx.Transaction.TransactionHash, - ) + suite.system.Submit(suite.ctx, suite.successTx.Transaction.TxEnvelope, suite.successXDR, suite.successTx.Transaction.TransactionHash, "") pending := suite.system.Pending.Pending(suite.ctx) assert.Equal(suite.T(), 1, len(pending)) assert.Equal(suite.T(), suite.successTx.Transaction.TransactionHash, pending[0]) @@ -350,11 +316,50 @@ func (suite *SystemTestSuite) TestSubmit_OpenTransactionList() { func (suite *SystemTestSuite) TestTick_Noop() { suite.db.On("BeginTx", &sql.TxOptions{ Isolation: sql.LevelRepeatableRead, - ReadOnly: true, + ReadOnly: false, }).Return(nil).Once() - suite.db.On("Rollback").Return(nil).Once() + suite.db.On("Commit").Return(nil).Once() + suite.db.MockQTxSubmissionResult.On("DeleteTxSubmissionResultsOlderThan", suite.ctx, uint64(300)). + Return(int64(0), nil).Once() + + suite.system.Tick(suite.ctx) +} + +// Delete should only be called every TTL +func (suite *SystemTestSuite) TestTick_DeleteEveryTTL() { + suite.db.On("BeginTx", &sql.TxOptions{ + Isolation: sql.LevelRepeatableRead, + ReadOnly: false, + }).Return(nil).Once() + suite.db.On("Commit").Return(nil).Once() + suite.db.MockQTxSubmissionResult.On("DeleteTxSubmissionResultsOlderThan", suite.ctx, uint64(300)). + Return(int64(0), nil).Once() + + suite.system.Tick(suite.ctx) + + // Delete shouldn't be called the second time since it should wait 300 seconds + + suite.db.On("BeginTx", &sql.TxOptions{ + Isolation: sql.LevelRepeatableRead, + ReadOnly: false, + }).Return(nil).Once() + suite.db.On("Commit").Return(nil).Once() + + suite.system.Tick(suite.ctx) + + // But it should be called a third time if we ensure the TTL has passed + suite.system.SubmissionResultTTL = time.Second + time.Sleep(2 * time.Second) + suite.db.On("BeginTx", &sql.TxOptions{ + Isolation: sql.LevelRepeatableRead, + ReadOnly: false, + }).Return(nil).Once() + suite.db.On("Commit").Return(nil).Once() + suite.db.MockQTxSubmissionResult.On("DeleteTxSubmissionResultsOlderThan", suite.ctx, uint64(1)). + Return(int64(0), nil).Once() suite.system.Tick(suite.ctx) + } // TestTick_Deadlock is a regression test for Tick() deadlock: if for any reason @@ -365,9 +370,9 @@ func (suite *SystemTestSuite) TestTick_Noop() { func (suite *SystemTestSuite) TestTick_Deadlock() { suite.db.On("BeginTx", &sql.TxOptions{ Isolation: sql.LevelRepeatableRead, - ReadOnly: true, + ReadOnly: false, }).Return(nil).Once() - suite.db.On("Rollback").Return(nil).Once() + suite.db.On("Commit").Return(nil).Once() // Start first Tick suite.system.SubmissionQueue.Push("address", 0, nil) @@ -378,23 +383,28 @@ func (suite *SystemTestSuite) TestTick_Deadlock() { suite.system.Tick(suite.ctx) }). Once() + suite.db.MockQTxSubmissionResult.On("DeleteTxSubmissionResultsOlderThan", suite.ctx, uint64(300)). + Return(int64(0), nil).Once() suite.system.Tick(suite.ctx) } // Test that Tick finishes any available transactions, -func (suite *SystemTestSuite) TestTick_FinishesTransactions() { +func (suite *SystemTestSuite) TestTick_FinishesResultTransactions() { l := make(chan Result, 1) suite.system.Pending.Add(suite.ctx, suite.successTx.Transaction.TransactionHash, l) suite.db.On("BeginTx", &sql.TxOptions{ Isolation: sql.LevelRepeatableRead, - ReadOnly: true, + ReadOnly: false, }).Return(nil).Once() - suite.db.On("Rollback").Return(nil).Once() - suite.db.On("TransactionsByHashesSinceLedger", suite.ctx, []string{suite.successTx.Transaction.TransactionHash}, uint32(940)). - Return(nil, sql.ErrNoRows).Once() - suite.db.On("NoRows", sql.ErrNoRows).Return(true).Once() + suite.db.On("Commit").Return(nil).Once() + suite.db.MockQTxSubmissionResult.On("GetTxSubmissionResults", suite.ctx, []string{suite.successTx.Transaction.TransactionHash}). + Return([]history.Transaction{}, nil).Once() + suite.db.On("TransactionsByHashesSinceLedger", suite.ctx, []string{suite.successTx.Transaction.TransactionHash}, mock.Anything). + Return([]history.Transaction{}, nil).Once() + suite.db.MockQTxSubmissionResult.On("DeleteTxSubmissionResultsOlderThan", suite.ctx, uint64(300)). + Return(int64(0), nil).Once() suite.system.Tick(suite.ctx) @@ -403,11 +413,37 @@ func (suite *SystemTestSuite) TestTick_FinishesTransactions() { suite.db.On("BeginTx", &sql.TxOptions{ Isolation: sql.LevelRepeatableRead, - ReadOnly: true, + ReadOnly: false, }).Return(nil).Once() - suite.db.On("Rollback").Return(nil).Once() - suite.db.On("TransactionsByHashesSinceLedger", suite.ctx, []string{suite.successTx.Transaction.TransactionHash}, uint32(940)). + suite.db.On("Commit").Return(nil).Once() + suite.db.MockQTxSubmissionResult.On("GetTxSubmissionResults", suite.ctx, []string{suite.successTx.Transaction.TransactionHash}). + Return([]history.Transaction{suite.successTx.Transaction}, nil).Once() + suite.db.On("TransactionsByHashesSinceLedger", suite.ctx, []string{suite.successTx.Transaction.TransactionHash}, mock.Anything). + Return([]history.Transaction{}, nil).Once() + suite.db.MockQTxSubmissionResult.On("DeleteTxSubmissionResultsOlderThan", suite.ctx, uint64(300)). + Return(int64(0), nil).Once() + + suite.system.Tick(suite.ctx) + + assert.Equal(suite.T(), 1, len(l)) + assert.Equal(suite.T(), 0, len(suite.system.Pending.Pending(suite.ctx))) +} + +func (suite *SystemTestSuite) TestTick_FinishesHistoryTransactions() { + l := make(chan Result, 1) + suite.system.Pending.Add(suite.ctx, suite.successTx.Transaction.TransactionHash, l) + + suite.db.On("BeginTx", &sql.TxOptions{ + Isolation: sql.LevelRepeatableRead, + ReadOnly: false, + }).Return(nil).Once() + suite.db.On("Commit").Return(nil).Once() + suite.db.MockQTxSubmissionResult.On("GetTxSubmissionResults", suite.ctx, []string{suite.successTx.Transaction.TransactionHash}). + Return([]history.Transaction{}, nil).Once() + suite.db.On("TransactionsByHashesSinceLedger", suite.ctx, []string{suite.successTx.Transaction.TransactionHash}, mock.Anything). Return([]history.Transaction{suite.successTx.Transaction}, nil).Once() + suite.db.MockQTxSubmissionResult.On("DeleteTxSubmissionResultsOlderThan", suite.ctx, uint64(300)). + Return(int64(0), nil).Once() suite.system.Tick(suite.ctx) @@ -440,24 +476,30 @@ func (suite *SystemTestSuite) TestTickFinishFeeBumpTransaction() { ReadOnly: true, }).Return(nil).Once() suite.db.On("Rollback").Return(nil).Once() - suite.db.On("TransactionByHash", suite.ctx, mock.Anything, innerHash). - Return(sql.ErrNoRows).Once() + suite.db.MockQTxSubmissionResult.On("GetTxSubmissionResult", suite.ctx, innerHash). + Return(history.Transaction{}, sql.ErrNoRows).Once() suite.db.On("NoRows", sql.ErrNoRows).Return(true).Once() suite.db.On("GetSequenceNumbers", suite.ctx, []string{"GABQGAYAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAB2MX"}). Return(map[string]uint64{"GABQGAYAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAB2MX": 96}, nil). Once() + suite.db.MockQTxSubmissionResult.On("InitEmptyTxSubmissionResult", suite.ctx, innerHash, ""). + Return(nil).Once() - l := suite.system.Submit(suite.ctx, innerTxEnvelope, parsedInnerTx, innerHash) + l := suite.system.Submit(suite.ctx, innerTxEnvelope, parsedInnerTx, innerHash, "") assert.Equal(suite.T(), 0, len(l)) assert.Equal(suite.T(), 1, len(suite.system.Pending.Pending(suite.ctx))) suite.db.On("BeginTx", &sql.TxOptions{ Isolation: sql.LevelRepeatableRead, - ReadOnly: true, + ReadOnly: false, }).Return(nil).Once() - suite.db.On("Rollback").Return(nil).Once() - suite.db.On("TransactionsByHashesSinceLedger", suite.ctx, []string{innerHash}, uint32(940)). + suite.db.On("Commit").Return(nil).Once() + suite.db.MockQTxSubmissionResult.On("GetTxSubmissionResults", suite.ctx, []string{innerHash}). Return([]history.Transaction{feeBumpTx.Transaction}, nil).Once() + suite.db.On("TransactionsByHashesSinceLedger", suite.ctx, []string{innerHash}, mock.Anything). + Return([]history.Transaction{}, nil).Once() + suite.db.MockQTxSubmissionResult.On("DeleteTxSubmissionResultsOlderThan", suite.ctx, uint64(300)). + Return(int64(0), nil).Once() suite.system.Tick(suite.ctx) @@ -477,12 +519,15 @@ func (suite *SystemTestSuite) TestTick_RemovesStaleSubmissions() { suite.db.On("BeginTx", &sql.TxOptions{ Isolation: sql.LevelRepeatableRead, - ReadOnly: true, + ReadOnly: false, }).Return(nil).Once() - suite.db.On("Rollback").Return(nil).Once() - suite.db.On("TransactionsByHashesSinceLedger", suite.ctx, []string{suite.successTx.Transaction.TransactionHash}, uint32(940)). - Return(nil, sql.ErrNoRows).Once() - suite.db.On("NoRows", sql.ErrNoRows).Return(true).Once() + suite.db.On("Commit").Return(nil).Once() + suite.db.MockQTxSubmissionResult.On("GetTxSubmissionResults", suite.ctx, []string{suite.successTx.Transaction.TransactionHash}). + Return([]history.Transaction{suite.successTx.Transaction}, nil).Once() + suite.db.On("TransactionsByHashesSinceLedger", suite.ctx, []string{suite.successTx.Transaction.TransactionHash}, mock.Anything). + Return([]history.Transaction{}, nil).Once() + suite.db.MockQTxSubmissionResult.On("DeleteTxSubmissionResultsOlderThan", suite.ctx, uint64(300)). + Return(int64(0), nil).Once() suite.system.Tick(suite.ctx) diff --git a/support/db/batch_insert_builder.go b/support/db/batch_insert_builder.go index ee6427286d..0d421b00ea 100644 --- a/support/db/batch_insert_builder.go +++ b/support/db/batch_insert_builder.go @@ -118,7 +118,7 @@ func (b *BatchInsertBuilder) Exec(ctx context.Context) error { sql = sql.Values(row...) paramsCount += len(row) - if paramsCount > postgresQueryMaxParams-2*len(b.columns) { + if paramsCount > PostgresQueryMaxParams-2*len(b.columns) { _, err := b.Table.Session.Exec(ctx, sql) if err != nil { return errors.Wrap(err, fmt.Sprintf("error adding values while inserting to %s", b.Table.Name)) diff --git a/support/db/main.go b/support/db/main.go index 5a316899c5..c792ba10da 100644 --- a/support/db/main.go +++ b/support/db/main.go @@ -25,8 +25,8 @@ import ( ) const ( - // postgresQueryMaxParams defines the maximum number of parameters in a query. - postgresQueryMaxParams = 65535 + // PostgresQueryMaxParams defines the maximum number of parameters in a query. + PostgresQueryMaxParams = 65535 maxDBPingAttempts = 30 )